Default PHP Extensions¶

The following extensions are enabled by default:

• bcmath
• bz2 (not in 7.0)
• calendar
• ctype
• curl
• date
• dba
• dom
• ereg (5.6 and earlier)
• exif
• fileinfo
• filter
• ftp
• gd
• gettext
• hash
• iconv
• intl
• json
• libxml
• mbstring
• mcrypt (5.6 and earlier)
• mhash (5.6 and earlier)
• mysql (5.6 and earlier)
• mysqli
• mysqlnd
• openssl
• pcntl
• pcre
• pdo
• pdo_mysql
• pdo_sqlite
• phar
• posix
• session
• shmop (5.6 and earlier)
• simplexml
• soap
• sockets
• sqlite3
• sysvmsg
• sysvsem
• sysvshm
• tokenizer
• wddx (5.6 and earlier)
• xml
• xmlreader
• xmlwriter
• zendopcache (5.4 only) / opcache (5.5 and later)
• zip
• zlib

Available PHP Extensions¶

This is the complete list of extensions supported by SymfonyCloud and the PHP versions where they can be enabled:

Custom PHP Extensions¶

You can also use a not-listed PHP extension by following these steps:

1. Download the .so file for the extension as part of your build hook using curl or similar.

   Note

   Alternatively, if the file is not publicly downloadable, you can also build the extension in your build section (although this means rebuilding the same extension on every deployment) or add the file to your Git repository (although committing large binary blobs to Git is generally not recommended).

2. Edit your php.ini file in the application root (as a sibling of your .symfony.cloud.yaml file) that loads the extension using its absolute path:

   1 2	; php.ini extension=/app/myextension.so

Measuring PHP Worker Memory Usage¶

To see how much memory your PHP worker processes are using, look at the PHP access log:

1

$ symfony log php.access

In the fifth column, you'll see the peak memory usage that occurred while each request was handled. A good way to determine an optimal request memory is with the following command:

1

$ tail -n5000 /var/log/php.access.log | awk '{print $6}' | sort -n | uniq -c

This will print out a table of how many requests used how much memory, in KB, for the last 5,000 requests that reached PHP-FPM (increase that number if your site has lot of traffic). As an example, consider the following output:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

4800 2048
 948 4096
 785 6144
 584 8192
 889 10240
 492 12288
 196 14336
  68 16384
   2 18432
   1 22528
   6 131072

This indicates that the majority of requests (4800) used 2048 KB of memory. In this case that's likely application caching at work. Most requests used up to around 10 MB of memory, while a few used as much as 18 MB and a very very few (6 requests) peaked at 131 MB.

A conservative approach would suggest an average request memory of 16 MB should be sufficient. A more aggressive stance would suggest 10 MB. The more aggressive approach would potentially allow for more concurrent requests at the risk of some requests needing to use swap memory, thus slowing them down.

Error Handling¶

By default, display_errors is set to On to ease setting up your project. We strongly recommend providing a custom error handler in your application or setting this value to Off before you make your site live and this is done automatically for you during initial configuration using the project:init command:

PHP Timezone¶

You can change the timezone of the PHP runtime with the following configuration:

Check out the main Timezone article to learn more about setting the timezone of other services.

Runtime configuration¶

In addition to PHP Configuration, SymfonyCloud also lets you configure the PHP-FPM runtime via the runtime section on the .symfony.cloud.yaml file. The following options are configurable:

• request_terminate_timeout: The timeout for serving a single request after which the PHP-FPM worker process will be killed. This option should be used when the max_execution_time ini option does not stop script execution for some reason.

  1 2 3

  # .symfony.cloud.yaml runtime: request_terminate_timeout: 300

• sizing_hints: Hints given to SymfonyCloud to compute the optimal number of workers serving HTTP requests. See PHP Worker Sizing Hints for more information.

  1 2 3 4 5 6

  # .symfony.cloud.yaml runtime: sizing_hints: # values are considered megabytes request_memory: 10 reserved_memory: 70