Add PHP Settings

PHP-Settings.md

@@ -0,0 +1,83 @@
+## PHP Settings Documentation for Joomla Get Bible
+
+Proper configuration of PHP settings is crucial for optimizing the performance and reliability of your Joomla Get Bible (JGB) environment. Below, we'll discuss the importance of each PHP setting specified in the code and provide step-by-step instructions for configuring these settings across various platforms.
+
+### Important PHP Settings
+
+#### 1. `upload_max_filesize` (64M)
+This setting determines the maximum size of an uploaded file. For JGB, where large files such as components and media may be uploaded, it's vital to have a high limit to prevent upload failures.
+
+#### 2. `post_max_size` (128M)
+This setting limits the size of POST data that PHP will accept, which includes uploaded files. Setting this to a value larger than `upload_max_filesize` ensures that data isn't truncated during submissions, which is essential for the integrity of data in forms and uploads.
+
+#### 3. `max_execution_time` (60 seconds)
+This setting controls the maximum time a script is allowed to run before it is terminated by the parser. A longer time allows for the execution of complex operations without interruptions, which is crucial during the installation or updates of large components.
+
+#### 4. `max_input_vars` (5000)
+The `max_input_vars` setting limits the number of input variables (e.g., from GET, POST, and COOKIE data). Increasing this limit supports more detailed forms and complex configurations in JGB.
+
+#### 5. `max_input_time` (60 seconds)
+This setting determines how much time PHP will wait to receive file uploads and POST data, important for handling large data volumes under heavy load conditions.
+
+#### 6. `memory_limit` (256M)
+This setting specifies the maximum amount of memory a script may consume. It is essential to process large data sets and perform complex calculations without interruptions or crashes.
+
+### Configuring PHP Settings
+
+#### On Local Machines (Windows, Mac, and Linux)
+
+1. **Locate your PHP.ini File:**
+   - **Windows:** Typically found in `C:\php\php.ini`.
+   - **Mac/Linux:** Usually `/etc/php/{version}/php.ini` or `/usr/local/etc/php/{version}/php.ini`.
+
+2. **Edit the PHP.ini File:**
+   - Use a text editor to open `php.ini`.
+   - Modify the settings as follows:
+     ```
+     upload_max_filesize = 64M
+     post_max_size = 128M
+     max_execution_time = 60
+     max_input_vars = 5000
+     max_input_time = 60
+     memory_limit = 256M
+     ```
+   - Save the changes.
+
+3. **Restart Your Web Server:**
+   - Restart Apache/Nginx to apply the changes.
+
+#### On Development Ubuntu Server (OctoJoom->Docker, cPanel, VirtualMin, or CWP)
+
+**Using [OctoJoom](https://git.vdm.dev/octoleo/octojoom)->Docker:**
+- Set Octojoom to expert mode, and then during the creation of a new Joomla container it will ask if you would like to set custom PHP values.
+
+**Using cPanel:**
+- Navigate to "Software" and find "Select PHP Version".
+- Click on "Switch to PHP Options".
+- Adjust the values as needed and save the settings.
+
+**Using VirtualMin:**
+- Go to "Services" > "PHP Configuration".
+- Adjust the PHP settings in the provided UI.
+
+**Using CWP (CentOS Web Panel):**
+- Access the PHP Configuration editor under "PHP Settings".
+- Modify and save the desired values.
+
+### Required PHP Modules for Joomla
+
+To ensure optimal operation of Joomla, the following PHP modules should be enabled. These are typically included in standard PHP installations and can be verified via the `phpinfo()` function or command line (`php -m`):
+
+- **mysqli** or **pdo_mysql** (for MySQL databases)
+- **gd** (for image processing)
+- **curl** (for data fetching from external sources)
+- **xml** and **json** (for XML and JSON parsing, respectively)
+- **mbstring** (for multi-byte string processing)
+- **zip** (for handling zip archives)
+- **openssl** (for secure data transmission)
+
+For more detailed configuration and additional modules, consider the instructions provided by the [official Joomla Docker image](https://github.com/joomla/docker-joomla).
+
+### Conclusion
+
+Configuring your PHP environment correctly is essential for efficient and reliable Joomla Component Builder operation. These settings provide the necessary resources to handle complex operations, large files, and high data loads typical in component development and management. For further details and the latest recommendations, always refer to the [PHP official documentation](https://www.php.net/manual/en/ini.core.php).