GoAdmio

reload

Gracefully reload every installed PHP-FPM version and the active web server (Nginx or Apache)

On this page: Overview · Quick start · Syntax · Options · Output · Examples · Troubleshooting · Details · See also


Overview

/go/reload asks PHP-FPM and the web server to reload their configuration without dropping connections — a graceful reload (systemctl reload), not a restart. It reloads every installed PHP-FPM version, then the web server currently in use (Nginx or Apache/httpd).

[!NOTE] This is a different command from /go/fpm reload (the fpm command, called with a reload argument), which several other commands schedule automatically after changing a php.ini setting. /go/reload documented here is its own standalone command and also reloads the web server, not just PHP-FPM.

The call is appended to /var/log/go/reload.log.


Quick start

/go/reload

Syntax

/go/reload

The command takes no arguments.


Options

None.


Output

The command prints nothing on success. If a systemctl reload call fails (for example, a web server config error), systemctl's own error goes to the terminal, but the script continues to the next reload regardless.


Examples

# After editing a vhost or php.ini by hand
/go/reload
# Check a service's status if something seems off afterward
systemctl status nginx
systemctl status php8.3-php-fpm   # RHEL family naming
systemctl status php8.3-fpm       # Debian/Ubuntu naming

Troubleshooting

Symptom Likely cause Fix
Unit php-fpm.service not found or similar on the RHEL family This command tries to reload a plain php-fpm service in addition to each versioned one; if no such service exists on your server, this call fails while the rest of the script continues. Check systemctl list-units '*php-fpm*' for the actual unit names in use; the per-version reloads that follow still happen.
Changes don't appear to take effect A reload only picks up configuration changes; it doesn't help if the web server or PHP-FPM failed to start in the first place, and a config syntax error can make the reload itself fail quietly. Check systemctl status for the relevant service, and validate the config (nginx -t, apachectl configtest) before reloading.
The wrong web server gets reloaded (Nginx reloaded on an Apache server, or the reverse) The check compares the saved web server setting to the literal string NGINX, case-sensitively; anything that doesn't match exactly falls back to Apache/httpd. Confirm which web server is actually in use with systemctl status nginx / systemctl status httpd (or apache2).
cd: /etc/opt/remi: No such file or directory or cd: /etc/php: No such file or directory No PHP version is installed yet. Install one with installphp first.

Details

What it does

  1. Waits one second.
  2. RHEL family: reloads php-fpm, then reloads <version>-php-fpm for every version folder under /etc/opt/remi that has a php.ini.
  3. Debian and Ubuntu: reloads php<version>-fpm for every version folder under /etc/php that has an fpm/php.ini. There is no equivalent unversioned reload attempted here, unlike the RHEL branch.
  4. Reloads the web server: nginx if the saved web server setting is exactly NGINX, otherwise httpd (RHEL family) or apache2 (Debian/Ubuntu).

Known issues


See also

Command Description
fpm Restart all installed PHP-FPM versions on your server
restart Restart all PHP-FPM pools and the active web server
web Restart or reload the active web server
checkapache Validate the Apache configuration
checknginx Validate the Nginx configuration and remove vhosts with no site directory
conf Rebuild the Apache/Nginx configuration in GoAdmio