Nginx和PHP-FPM源码编译安装后的系统服务脚本配置指南

Nora
Nora
发布时间:2026-10-14| 3人浏览过
原创

对于非包管理器默认安装的Linux服务器(如CentOS/RHEL),手动编译安装的Nginx与PHP-FPM往往无法直接使用systemctl或service命令管理。本文将介绍如何编写基于/etc/init.d的Shell脚本,配合chkconfig工具,将这两个核心组件注册为系统服务,从而实现标准化的启停与重载操作。

结果与目标

完成以下操作后,用户可在终端中直接执行 service nginx start/stop/restart 和 service php-fpm start/stop/restart 来管理服务,无需记忆复杂的进程路径或信号命令。

准备条件

  • 操作系统环境:该方案主要适用于 CentOS、RHEL 7 及以下版本或 Fedora 等传统 SysVinit 体系系统。
  • 安装方式:Nginx 和 PHP-FPM 均为源码编译安装,且已按常规习惯部署在 /usr/local/nginx 和 /usr/local/php 目录下(若路径不同,需修改下文脚本中的变量)。
  • 配置文件:/etc/sysconfig/network 存在且网络状态正常;Nginx 配置文件位于 /usr/local/nginx/conf/nginx.conf;PHP-FPM 配置文件位于 /usr/local/php/etc/php-fpm.conf。

第1步:创建 Nginx 初始化脚本

目的:编写启动、停止、重载逻辑,供 System V Init 调用。

操作入口:SSH 终端,文本编辑器(如 vi/vim)。

动作详情: 创建文件 /etc/init.d/nginx,写入以下标准 Shell 脚本内容。请注意核对脚本头部注释中的 chkconfig 行以及变量定义部分是否与您的实际安装路径一致。

#!/bin/bash
#
# Startup script for Nginx - this script starts and stops the nginx daemon
#
# chkconfig:   - 85 15
# description:  Nginx is an HTTP(S) server, HTTP(S) reverse proxy and IMAP/POP3 proxy server
# processname: nginx
# config:       /usr/local/nginx/conf/nginx.conf
# pidfile:      /usr/local/nginx/logs/nginx.pid

# Source function library.
. /etc/rc.d/init.d/functions

# Source networking configuration.
. /etc/sysconfig/network

# Check that networking is up.
[ "$NETWORKING" = "no" ] && exit 0

nginx="/usr/local/nginx/sbin/nginx"
prog=$(basename $nginx)

NGINX_CONF_FILE="/usr/local/nginx/conf/nginx.conf"

[ -f /etc/sysconfig/nginx ] && . /etc/sysconfig/nginx

lockfile=/var/lock/subsys/nginx

start() {
    [ -x $nginx ] || exit 5
    [ -f $NGINX_CONF_FILE ] || exit 6
    echo -n $"Starting $prog: "
    daemon $nginx -c $NGINX_CONF_FILE
    retval=$?
    echo
    [ $retval -eq 0 ] && touch $lockfile
    return $retval
}

stop() {
    echo -n $"Stopping $prog: "
    killproc $prog -QUIT
    retval=$?
    echo
    [ $retval -eq 0 ] && rm -f $lockfile
    return $retval
}

restart() {
    configtest || return $
    stop
    sleep 1
    start
}

reload() {
    configtest || return $
    echo -n $"Reloading $prog: "
    killproc $nginx -HUP
    RETVAL=$?
    echo
}

force_reload() {
    restart
}

configtest() {
  $nginx -t -c $NGINX_CONF_FILE
}

rh_status() {
    status $prog
}

rh_status_q() {
    rh_status >/dev/null 2&&1
}

case "$1" in
    start)
        rh_status_q && exit 0
        $1
        ;;
    stop)
        rh_status_q || exit 0
        $1
        ;;
    restart|configtest)
        $1
        ;;
    reload)
        rh_status_q || exit 7
        $1
        ;;
    force-reload)
        force_reload
        ;;
    status)
        rh_status
        ;;
    condrestart|try-restart)
        rh_status_q || exit 0
              ;;
    *)
        echo $"Usage: $0 {start|stop|status|restart|condrestart|try-restart|reload|force-reload|configtest}"
        exit 2
esac
保存文件。

第2步:激活 Nginx 系统服务

说明:赋予执行权限并将 Nginx 加入开机自启列表。

关键参数与命令:

  1. 授予脚本执行权限:sudo chmod +x /etc/init.d/nginx
  2. 开启开机启动:sudo /sbin/chkconfig nginx on
  3. 验证状态:sudo /sbin/chkconfig --list nginx 期望输出包含 Runlevel 2-5 为 on。

至此,Nginx 服务配置完毕。可使用以下任一命令管理 Nginx:

# 推荐用法
service nginx start|stop|restart|reload

# 或直接调用脚本
/etc/init.d/nginx start|stop|restart|reload

第3步:创建 PHP-FPM 初始化脚本

说明:PHP-FPM 同样需要独立的 init.d 脚本来处理生命周期管理。

动作详情:创建文件 /etc/init.d/php-fpm,填入以下内容。

#!/bin/bash
#
# Startup script for the PHP-FPM server.
#
# chkconfig: 345 85 15
# description: PHP is an HTML-embedded scripting language
# processname: php-fpm
# config: /usr/local/php/etc/php.ini

# Source function library.
. /etc/rc.d/init.d/functions

PHP_PATH=/usr/local
DESC="php-fpm daemon"
NAME=php-fpm
# php-fpm路径
DAEMON=$PHP_PATH/php/sbin/$NAME
# 配置文件路径
CONFIGFILE=$PHP_PATH/php/etc/php-fpm.conf
# PID文件路径(在php-fpm.conf设置)
PIDFILE=$PHP_PATH/php/var/run/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME

# Gracefully exit if the package has been removed.
test -x $DAEMON || exit 0

rh_start() {
  $DAEMON -y $CONFIGFILE || echo -n " already running"
}

rh_stop() {
  kill -QUIT `cat $PIDFILE` || echo -n " not running"
}

rh_reload() {
  kill -HUP `cat $PIDFILE` || echo -n " can't reload"
}

case "$1" in
  start)
        echo -n "Starting $DESC: $NAME"
        rh_start
        echo "."
        ;;
  stop)
        echo -n "Stopping $DESC: $NAME"
        rh_stop
        echo "."
        ;;
  reload)
        echo -n "Reloading $DESC configuration..."
        rh_reload
        echo "reloaded."
  ;;
  restart)
        echo -n "Restarting $DESC: $NAME"
        rh_stop
        sleep 1
        rh_start
        echo "."
        ;;
  *)
        echo "Usage: $SCRIPTNAME {start|stop|restart|reload}" >&2
        exit 3
        ;;
esac
exit 0
保存文件。

第4步:激活 PHP-FPM 系统服务

说明:类似 Nginx,赋予权限并注册服务。

操作步骤:

  1. 执行 sudo chmod +x /etc/init.d/php-fpm
  2. 执行 sudo /sbin/chkconfig php-fpm on
  3. 查看是否成功加载:sudo /sbin/chkconfig --list php-fpm

完成后,即可使用 service php-fpm 系列命令进行控制:

service php-fpm start|stop|restart|reload

总结

通过上述步骤,我们在传统 Linux 发行版上实现了源码安装的 Web 环境标准化服务管理。这不仅简化了运维指令,也确保了服务在系统重启时的自动拉起。如果您使用的是较新的 Ubuntu 16.04+ 或 CentOS 7+ 默认支持 systemd 的系统,建议优先探索使用 .service 单元文件的方式进行配置,以获得更完善的依赖管理和日志集成能力。以上就是Nginx和PHP-FPM系统服务脚本配置的详细内容,更多关于Linux服务器运维优化的资料请关注本站其它相关文章!

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。