PHP configuration

PHP can vary between OS distributions; see the documentation specific to your installation of PHP.

1. First determine which PHP .ini file is in use by the PHP Apache module.

   It may not necessarily be the same .ini file that is in use when calling PHP from the command line (running php --ini from the command line reports this).

   If you are having trouble determining which .ini file the PHP Apache module is using, create a PHP file that can be served through Apache with the following contents:

   <?php phpinfo();?>

   Point your browser to this file and look for this table row in the resulting table:

   Loaded Configuration File

2. Open the php.ini configuration file and increase the memory_limit to 512M, default value is 256M.

   Large changelists may fail to submit if the memory_limit is too low.

   An example memory_limit setting in php.ini:

   memory_limit = 512M
   

3. Ensure that date.timezone is set correctly for your system.

   Some distributions do not make a default timezone available to PHP, so the best practice to set the timezone for PHP explicitly. See the list of supported timezones.

   An example date.timezone setting in php.ini:

   date.timezone = America/Vancouver

4. Verify that the iconv, json, and session extensions are present.

   They are usually enabled by default, although you may have to install packages for them through your OS distribution. Verify they are present by searching for their respective names in the phpinfo output above.

5. Enable P4 API for PHP, the Perforce extension for PHP:

   For P4 Code Review to communicate with the P4 Server, it needs the P4 API for PHP extension. P4 API for PHP variants are available for each PHP 8 version supported by P4 Code Review and each variant is available as either openssl 1.02 or openssl 1.1.1. All of the P4 API for PHP variants are supplied with the P4 Code Review package and tarball installations.

   • For Linux, the default variants are compiled with glibc 2.11.
   • P4 API for PHP 2019.1 or later is required for P4 Code Review 2019.1 and later.

   P4 Code Review package and tarball installations: two versions of P4 API for PHP are supplied for PHP 8 version supported by P4 Code Review. They are located in the p4-bin/bin.linux26x86_64 directory.

   • perforce-php8x.so compatible with systems using SSL 1.0.2
   • perforce-php8x-ssl1.1.1.so compatible with systems using SSL 1.1.1
   • perforce-php8x-ssl3.so compatible with systems using SSL 3.0.0 (by default, Ubuntu 22.04 and 24.04 uses SSL 3.0.0)

   Where x is the version of PHP 8.

   P4 Code Review no longer supports PHP 8.0 version.

   If the perforce.ini file is not pointing at the correct version of P4 API for PHP and you connect to an SSL enabled P4 Server:

   • The P4 Code Review web-page will not load and you might see a Connection Reset error.
   • There might be an undefined symbol: SSLeay message in the Apache error log

   To enable P4 API for PHP, edit the web server's php.ini file and add the following line:

   extension=/path/to/swarm/p4-bin/bin.<platform>/perforce-<php8.x><ssl>.so

   Replace <php8.x> with the version of PHP 8 you are running.

   P4 Code Review no longer supports PHP 8.0 version.

   Supported versions of PHP 8 are as follows:

   • For PHP 8.1, use php81

   • For PHP 8.2, use php82

   • For PHP 8.3, use php83

   • For PHP 8.4, use php84

   Replace <ssl> with the variant of openssl your system is running. Enter the following into <ssl> for the variant of openssl you are running:

   • For SSL 1.0.2, you do not need to enter a variant. See Example 1 below.

   • For SSL 1.1.1, use ssl1.1.1

   • For SSL 3.0.0, use ssl3

   See the examples below:

   Example 1: for a 64-bit Linux system running PHP 8.1 and SSL 1.0.2:

   extension=/path/to/swarm/p4-bin/bin.linux26x86_64/perforce-php81.so

   Example 2: for a 64-bit Linux system running PHP 8.3 and SSL 1.1.1:

   extension=/path/to/swarm/p4-bin/bin.linux26x86_64/perforce-php83-ssl1.1.1.so

   Example 3: for a 64-bit Linux system running PHP 8.4 and SSL 3.0.0:

   extension=/path/to/swarm/p4-bin/bin.linux26x86_64/perforce-php84-ssl3.so

   Alternatively, copy the extension file to the default location for PHP extensions, and then just add this line instead:

   extension=perforce-<php8.x><ssl>.so

6. Restart Apache for the changes to become active.
7. To verify that P4 API for PHP is active, navigate to the phpinfo file you created above. You should then see a perforce section (search for "Perforce Module"). It should report that the module is enabled and display the version information.

Be aware that any operating system upgrades on the machine hosting P4 Code Review may involve updates to PHP. If this occurs, the PHP .ini file needs to be updated to point to the correct variant of P4 API for PHP to match the version of PHP that the upgraded operating system is using.

8. In addition, P4 Code Review greatly benefits from the following optional extension: ImageMagick extension for PHP to improve P4 Code Review's ability to preview graphic formats that web browsers typically cannot display, see ImageMagick (imagick) extension for PHP.
9. Configure P4 Code Review, see P4 Code Review configuration.

ImageMagick (imagick) extension for PHP

Imagick is a PHP extension that integrates the ImageMagick graphics library's API for the creation and manipulation of images. Enabling Imagick improves P4 Code Review's ability to preview graphics formats that web browsers typically cannot display and to create comment attachment thumbnails.

For more information, see:

• Image Processing (ImageMagick)
• imagick

Follow the instructions for your OS distribution: