This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
plugins:phpswitcher [2019/09/28 11:00] nuxwin |
plugins:phpswitcher [2019/10/04 20:22] (current) nuxwin |
||
---|---|---|---|
Line 1: | Line 1: | ||
<WRAP center round important 60%> | <WRAP center round important 60%> | ||
- | **Bear in mind that this documentation is for the last released version. If you use an older version, you must refer to the README.md file inside the plugin archive.** | + | **Bear in mind that this documentation is for the lastest PhpSwitcher plugin version. If you use an older version, you must refer to the README.md file inside the plugin archive.** |
</WRAP> | </WRAP> | ||
<markdown> | <markdown> | ||
- | # i-MSCP PhpSwitcher plugin v5.0.0 | + | # i-MSCP PhpSwitcher plugin v5.0.3 |
Provides additional PHP versions for customers. | Provides additional PHP versions for customers. | ||
Line 9: | Line 9: | ||
## Requirements | ## Requirements | ||
- | - One of the [supported distributions](#supported-distributions) | + | - One of the [supported distributions](#supported_distributions) |
- i-MSCP Serie ≥ 1.5.3 | - i-MSCP Serie ≥ 1.5.3 | ||
- The Fcgid or the FPM i-MSCP httpd server implementation | - The Fcgid or the FPM i-MSCP httpd server implementation | ||
Line 32: | Line 32: | ||
## Update | ## Update | ||
- | 1. Read the [UPDATE.md](./doc/UPDATE.md) file | + | 1. Read the UPDATE.md file inside the plugin archive |
2. Be sure that all requirements are met | 2. Be sure that all requirements are met | ||
3. Upload the plugin through the plugin management interface | 3. Upload the plugin through the plugin management interface | ||
Line 90: | Line 90: | ||
message by creating a new issue on our bug tracker. | message by creating a new issue on our bug tracker. | ||
- | #### Download directory | + | ### Download directory |
By default, the PHP sources are downloaded in the `/usr/local/src/phpswitcher` | By default, the PHP sources are downloaded in the `/usr/local/src/phpswitcher` | ||
Line 96: | Line 96: | ||
`--download-dir` option to the `php_compiler.pl` script. | `--download-dir` option to the `php_compiler.pl` script. | ||
- | #### Build directory | + | ### Build directory |
By default, the compiled PHP versions are build in the | By default, the compiled PHP versions are build in the | ||
Line 103: | Line 103: | ||
`php_compiler.pl` script. | `php_compiler.pl` script. | ||
- | #### Installation directory | + | ### Installation directory |
By default, the compiled PHP versions are installed in the | By default, the compiled PHP versions are installed in the | ||
Line 110: | Line 110: | ||
`php_compiler.pl` script. | `php_compiler.pl` script. | ||
- | #### Changes made on PHP sources | + | ### Changes made on PHP sources |
A set of patches is applied on PHP sources before configuring them. The patches | A set of patches is applied on PHP sources before configuring them. The patches | ||
Line 124: | Line 124: | ||
`nxw-` prefix in their names. | `nxw-` prefix in their names. | ||
- | #### PHP extensions | + | ### PHP extensions |
PHP extensions are the same that are provided by PHP versions from the Debian | PHP extensions are the same that are provided by PHP versions from the Debian | ||
PHP team. Most are compiled as shared module. | PHP team. Most are compiled as shared module. | ||
- | #### PHP build dependencies (since version 5.0.0) | + | ### PHP build dependencies (since version 5.0.0) |
The `php_compiler.pl` script install the build dependencies for you by creating | The `php_compiler.pl` script install the build dependencies for you by creating | ||
Line 135: | Line 135: | ||
purged after a successfull build. | purged after a successfull build. | ||
- | #### PHP runtime dependencies (since version 5.0.0) | + | ### PHP runtime dependencies (since version 5.0.0) |
The `php_compiler.pl` script install the PHP runtime dependencies for you by | The `php_compiler.pl` script install the PHP runtime dependencies for you by | ||
Line 141: | Line 141: | ||
These packages are purged only when you uninstall the plugin. | These packages are purged only when you uninstall the plugin. | ||
- | #### Build environment (since version 5.0.0) | + | ### Build environment (since version 5.0.0) |
Build perations are performed in a chroot environment by default. This allows to | Build perations are performed in a chroot environment by default. This allows to | ||
Line 150: | Line 150: | ||
option to the `php_compiler.pl` script. | option to the `php_compiler.pl` script. | ||
- | #### Parallel Execution (GNU make) | + | ### Parallel Execution (GNU make) |
For faster compilation, the parallel execution feature provided by GNU make is | For faster compilation, the parallel execution feature provided by GNU make is | ||
Line 161: | Line 161: | ||
for further details about this feature. | for further details about this feature. | ||
- | #### Installation layout | + | ### Installation layout |
For all PHP versions provided by the PHP compiler, the following installation | For all PHP versions provided by the PHP compiler, the following installation | ||
layout applies: | layout applies: | ||
- | ##### Common to all PHP SAPIs | + | #### Common to all PHP SAPIs |
- Main php.ini file: /opt/phpswitcher/%ymd%/php%version%/etc/php/php.ini | - Main php.ini file: /opt/phpswitcher/%ymd%/php%version%/etc/php/php.ini | ||
- Additional *.ini files: /opt/phpswitcher/%ymd%/php%version%/etc/php/conf.d | - Additional *.ini files: /opt/phpswitcher/%ymd%/php%version%/etc/php/conf.d | ||
- | ##### PHP cli SAPI | + | #### PHP cli SAPI |
- PHP CLI binary: /opt/phpswitcher/%ymd%/php%version%/bin/php | - PHP CLI binary: /opt/phpswitcher/%ymd%/php%version%/bin/php | ||
- | ##### PHP cgi SAPI | + | #### PHP cgi SAPI |
- PHP FastCGI binary: /opt/phpswitcher/%ymd%/php%version%/bin/php-cgi | - PHP FastCGI binary: /opt/phpswitcher/%ymd%/php%version%/bin/php-cgi | ||
- User php.ini files: /var/www/fcgi/%domain%/php%version%/php.ini | - User php.ini files: /var/www/fcgi/%domain%/php%version%/php.ini | ||
- | ##### PHP fpm SAPI | + | #### PHP fpm SAPI |
- PHP-FPM binary: /opt/phpswitcher/%ymd%/php%version%/sbin/psw%version%-fpm | - PHP-FPM binary: /opt/phpswitcher/%ymd%/php%version%/sbin/psw%version%-fpm | ||
Line 196: | Line 196: | ||
Note that the `psw` prefix stands for `PhpSwitcher`. | Note that the `psw` prefix stands for `PhpSwitcher`. | ||
- | ##### Static paths (since version 5.0.0) | + | #### Static paths (since version 5.0.0) |
For convenience, the `php_compiler.pl` script also creates symlinks to the | For convenience, the `php_compiler.pl` script also creates symlinks to the | ||
Line 498: | Line 498: | ||
i-MSCP License <https://www.i-mscp.net/license-agreement.html> | i-MSCP License <https://www.i-mscp.net/license-agreement.html> | ||
``` | ``` | ||
- | |||
- | See the LICENSE file for further details. | ||
- | |||
</markdown> | </markdown> |