PHP can vary between OS distributions; see the documentation specific to your installation of PHP.
First determine which PHP
.inifile is in use by the PHP Apache module.Note
It may not necessarily be the same
.inifile that is in use when calling PHP from the command line (running
php --inifrom the command line reports this).
If you are having trouble determining which
.inifile the PHP Apache module is using, create a PHP file that can be served through Apache with the following contents:
Point your browser to this file and look for this table row in the resulting table:
Loaded Configuration File
date.timezoneis 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.
date.timezone = America/Vancouver
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
Enable P4PHP, the Perforce extension for PHP:
For Swarm to communicate with the Helix Core Server, it needs the P4PHP extension. P4PHP variants are available for each PHP 7 version supported by Swarm and each variant is available as either openssl 1.02 or openssl 1.1.1. All of the P4PHP variants are supplied with the Swarm package and tarball installations.Note
- For Linux, the default variants are compiled with glibc 2.11.
- P4PHP 2019.1 or later is required for Swarm 2019.1 and later.
- perforce-php7x.so compatible with systems using SSL 1.0.2
- perforce-php7x-ssl1.1.1.so compatible with systems using SSL 1.1.1 (by default Ubuntu 18.04 and Ubuntu 20.04 use SSL 1.1.1)
- The Swarm 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
Swarm package and tarball installations: 2 versions of P4PHP are supplied for each PHP 7 version supported by Swarm. They are located in the p4-bin/bin.linux26x86_64 directory.
Where x is the version of PHP 7.
If the perforce.ini file is not pointing at the correct version of P4PHP and you connect to an SSL enabled Helix Core Server:
To enable P4PHP, edit the web server's
php.inifile and add the following line:
Example 1: for a 64-bit Linux system running PHP 7.2 and SSL 1.0.2:
Example 2: for a 64-bit Linux system running PHP 7.4 and SSL 1.0.2:
Example 3: for a 64-bit Linux system running PHP 7.2 and SSL 1.1.1:
Example 4: for a 64-bit Linux system running PHP 7.4 and SSL 1.1.1:
Alternatively, copy the extension file to the default location for PHP extensions, and then just add this line instead:
- Restart Apache for the changes to become active.
- To verify that P4PHP is active, navigate to the
phpinfofile 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.
- In addition, Swarm greatly benefits from the following optional extension: ImageMagick extension for PHP to improve Swarm's ability to preview graphic formats that web browsers typically cannot display, see ImageMagick (imagick) extension for PHP.
- Configure Swarm, see Swarm configuration.
Be aware that any operating system upgrades on the machine hosting Swarm may involve updates to PHP. If this occurs, the PHP .ini file needs to be updated to point to the correct
variant of P4PHP to match the version of PHP that the upgraded operating system is using.
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 Swarm's ability to preview graphics formats that web browsers typically cannot display and to create comment attachment thumbnails.
For more information, see:
We recommend that you install Imagick from your OS distribution, via
yum, etc. If your distribution does not offer the imagick package for PHP, install it via PECL (although you may have to resolve system dependencies):
sudo pecl install imagick
Verify that imagick is enabled in your PHP Apache module's PHP
.inifile (as determined in the section above for P4PHP). You may need to add the following line:
Configure the ImageMagick policy.xml file to allow Swarm to create thumbnails if it is not already configured:
Open the ImageMagick policy.xml file for editing:
Disable lines with the pattern below for the following <filetype>s: PS, PS2, EPS, PDF, or XPS:
Save the policy.xml file.
- Restart Apache for the changes to become active.
To verify that imagick is active, navigate to the
phpinfofile you created earlier. You should then see an imagick section. It should report its version information and a table for its directives, supported image file formats, and more.Warning
Once you have completed installing and enabling P4PHP and imagick, we recommend that you remove the
phpinfofile you created to avoid disclosing information about your installation.
<policy domain="coder" rights="none" pattern="<filetype>" />