Upsun User Documentation

Troubleshoot PHP

Try Upsun for 15 days
After that, enjoy the same, game-changing Upsun features for less with the First Project Incentive!¹ A monthly $19 perk!
¹Terms and conditions apply
Activate your 15-day trial

For more general information, see how to troubleshoot development.

Server reached max_children Anchor to this heading

If the server is receiving more concurrent requests than it has PHP processes allocated, you encounter a message like the following:

/var/log/app.log
WARNING: [pool web] server reached max_children setting (2), consider raising it

This means some requests have to wait until another finishes. Upsun sets the number of workers based on the available memory of your container and the estimated average memory size of each process.

You have two ways to increase the number of workers:

Execution timeout Anchor to this heading

If your PHP app can’t handle the amount of traffic or is slow, you encounter a message like the following:

/var/log/app.log
WARNING: [pool web] child 120, script '/app/public/index.php' (request: "GET /index.php") execution timed out (358.009855 sec), terminating

This means your PHP process is running longer than allowed. You can adjust the max_execution_time value in php.ini, but there is still a hard cap of 5 minutes on any web request.

The most common causes of a timeout are an infinite loop (which is a bug that you should fix) or the work itself requires a long time to complete. For the latter case, you should consider putting the task into a background job.

The following command identifies the 20 slowest requests in the past hour, which can provide an indication of what code paths to investigate.

grep $(date +%Y-%m-%dT%H --date='-1 hours') /var/log/php.access.log | sort -k 4 -r -n | head -20

If you see that the processing time of certain requests is slow (such as taking longer than 1000 ms), you should consider a continuous observability solution to monitor your app and help you improve the performance issue.

Full access to Blackfire.io is bundled with your PHP and Python Upsun projects.

Otherwise, you may check if the following options are applicable:

Troubleshoot a crashed PHP process Anchor to this heading

If your PHP process crashed with a segmentation fault, you encounter a message like the following:

/var/log/app.log
WARNING: [pool web] child 112 exited on signal 11 (SIGSEGV) after 7.405936 seconds from start

Either a PHP extension is hitting a segmentation fault or your PHP app code is crashing. Review recent changes in your app and try to find the root cause. You might want to use a tool such as Xdebug for quicker troubleshooting.

Troubleshoot a killed PHP process Anchor to this heading

If your PHP process is killed by the kernel, you encounter a message like the following:

/var/log/app.log
WARNING: [pool web] child 429 exited on signal 9 (SIGKILL) after 50.938617 seconds from start

That means the memory usage of your container exceeds the limit that’s been allocated, so the kernel kills the offending process. To solve this issue, try the following approaches:

  • Check if the memory usage of your app is as expected and try to optimize it.
  • Use sizing hints to reduce the amount of PHP workers, which reduces the memory footprint.
  • Add additional resources with the upsun resources:set command

Restart PHP processes stuck during a build or deployment Anchor to this heading

If your build or deployment is running longer than expected, it might be because of a PHP process getting stuck.

To restart your PHP processes, run the following command in your app container:

pkill -f php-fpm

Resource temporarily unavailable Anchor to this heading

If all PHP workers are busy, you encounter a message like the following:

/var/log/error.log
connect() to unix:/run/app.sock failed (11: Resource temporarily unavailable)

This can be because too many requests are coming in at once or the requests are taking too long to be processed (such as with calls to external third-party servers without timeouts).

To address the issue, you can:

  • Lower the memory consumption of each request so that the amount of PHP workers gets automatically raised. This can be customized with the runtime.sizing_hints.request_memory key in your .upsun/config.yaml file. For more details, consult PHP-FPM sizing.
  • Add a CDN.
  • Set up HTTP caching.
  • Follow the global performance tuning recommendations.
  • Remove stale plugins and extensions when using a CMS.
  • Add additional resources with the upsun resources:set command

Is this page helpful?