LNMP环境下如何部署PHP应用

LNMP环境下部署PHP应用的实操指南

想把你的PHP应用稳稳当当地跑起来？LNMP（Linux, Nginx, MySQL, PHP）这套黄金组合，依然是当下最经典、最高效的选择之一。下面这份手把手的部署指南，将带你从零开始，避开那些常见的“坑”，直达成功上线。

一 准备与安装

万事开头，先把地基打好。这里以Ubuntu/Debian为例，CentOS系列的思路也大同小异，只是包管理器和个别路径稍有不同。

• 更新系统并安装组件（以 Ubuntu/Debian 为例）：
  • 更新与基础组件：第一步，总是让系统保持最新：sudo apt-get update && sudo apt-get upgrade。
  • 安装 Nginx：接着，把我们的Web服务器请进来：sudo apt-get install nginx。
  • 安装 MySQL：数据库服务紧随其后：sudo apt-get install mysql-server。安装完成后，别忘了运行sudo mysql_secure_installation来完成安全初始化，这可是保护数据库的第一道防线。
  • 安装 PHP 与常用扩展（示例为 PHP 7.4，请按实际替换为你的版本）：主角登场：sudo apt-get install php7.4-fpm php7.4-mysql php-mbstring php-xml php-zip。这里的扩展列表可以根据你的应用需求灵活增减。
• 目录与权限（示例站点根目录 /var/www/your_project/public）：
  • 创建目录：为你的项目安个家：sudo mkdir -p /var/www/your_project/public。
  • 设置属主：把目录所有权交给Web服务用户，避免后续权限烦恼：sudo chown -R www-data:www-data /var/www/your_project。
• 说明：如果你用的是CentOS系列，完全不必担心。使用yum或dnf安装对应的nginx、php-fpm、mariadb-server即可，核心流程完全一致，只是服务名和配置文件路径略有差异，照着官方文档调整一下就行。

二 上传代码与数据库初始化

环境就绪，接下来就是把你的“宝贝”代码放上去，并把数据库准备好。

• 上传源码（二选一或结合使用）：
  • SCP：命令行爱好者的首选，简单直接：scp -r /path/to/your/php/source user@your_server_ip:/var/www/your_project。
  • FTP/图形化客户端（如 FileZilla）：对于图形界面更顺手的朋友，用这类工具上传到刚才创建的站点根目录即可。
• 数据库准备（示例）：
  • 登录：首先，进入MySQL的世界：mysql -u root -p。
  • 建库与授权：然后，按顺序执行以下命令，创建一个专属的数据库和用户：
    • CREATE DATABASE your_database;
    • CREATE USER ‘your_user’@‘localhost’ IDENTIFIED BY ‘your_password’;
    • GRANT ALL PRIVILEGES ON your_database.* TO ‘your_user’@‘localhost’;
    • FLUSH PRIVILEGES;
  • 导入结构/数据：如果你的项目有现成的SQL文件，一条命令即可导入：mysql -u your_user -p your_database < /path/to/your/sqlfile.sql。
• 安全建议：这里有个关键点必须提醒：像.env这类包含数据库密码等敏感信息的配置文件，千万不要提交到代码仓库。正确的做法是，在服务器上手动创建并配置，同时将其文件权限设置为仅属主可读（如600）。

三 Nginx与PHP-FPM配置

这是让Nginx和PHP“握手”成功的关键一步，配置对了，应用才能流畅运行。

• 站点配置（Ubuntu/Debian 常用 sites-a vailable/sites-enabled 机制）：
  • 新建：为你的域名创建一个站点配置文件：sudo nano /etc/nginx/sites-a vailable/your_domain。
  • 示例配置（按需调整 root、server_name、fastcgi_pass 的 socket 路径与 PHP 版本）：将以下配置粘贴进去，并根据你的实际情况修改server_name（你的域名）、root（项目public目录路径）以及fastcgi_pass（PHP-FPM的socket路径）。

    server {
        listen 80;
        server_name your_domain;
        root /var/www/your_project/public;
    
        index index.php index.html index.htm;
    
        location / {
            try_files $uri $uri/ /index.php?$query_string;
        }
    
        location ~ \.php$ {
            include snippets/fastcgi-php.conf;
            fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; # 按实际版本与路径修改
        }
    
        location ~ /\.ht {
            deny all;
        }
    }

  • 启用站点：创建一个符号链接，让Nginx加载这个配置：sudo ln -s /etc/nginx/sites-a vailable/your_domain /etc/nginx/sites-enabled/。
• PHP-FPM 关键项（以 PHP 7.4 为例）：
  • 编辑池配置：sudo nano /etc/php/7.4/fpm/pool.d/www.conf。
  • 确认监听：找到listen这一行，确保其值与上面Nginx配置中的fastcgi_pass完全一致，例如：listen = /var/run/php/php7.4-fpm.sock。
  • 安全与性能：在/etc/php/7.4/fpm/php.ini中，建议将cgi.fix_pathinfo设置为0以提升安全性。同时，根据应用需求调整memory_limit、max_execution_time等参数。
• 校验与生效：
  • 语法检查：在重启前，务必先检查配置语法是否正确：sudo nginx -t。看到“syntax is ok”才算过关。
  • 重启服务：最后，让改动生效：sudo systemctl reload nginx && sudo systemctl restart php7.4-fpm。
• CentOS 差异提示：
  • 配置文件通常放在/etc/nginx/conf.d/目录下，例如default.conf。
  • PHP-FPM的监听地址可能是unix:/run/php-fpm/www.sock或127.0.0.1:9000，务必与Nginx中的fastcgi_pass对应上。
  • 在配置PHP解析时，可能需要显式设置SCRIPT_FILENAME参数：fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;。

四 多环境与PHP版本切换

实际工作中，我们常常需要应对更复杂的场景，比如多环境部署，或者在同一台服务器上运行不同PHP版本的应用。

• 多环境部署（开发/测试/生产）：
  • 可以为开发、测试、生产环境分别创建独立的Nginx配置文件，例如：/etc/nginx/sites-a vailable/dev.conf、test.conf、prod.conf。
  • 使用不同的目录、域名或端口进行区分，这样做的好处是隔离清晰，便于进行灰度发布和快速回滚。
  • 环境间的差异配置（如APP_ENV、数据库连接串），强烈推荐通过.env文件来管理。Nginx中甚至可以通过env指令引入环境变量，不过要注意其作用域限制。
• PHP 版本切换（同一服务器多版本共存）：
  • 安装多版本：首先，安装你需要的多个PHP版本及其FPM组件，例如：sudo apt-get install php7.2 php7.4 php7.2-fpm php7.4-fpm。
  • 方式一（全局切换）：如果想将所有站点切换到另一个PHP版本，只需修改Nginx配置中fastcgi_pass指向新版本的socket路径（如/run/php/php7.2-fpm.sock），然后重载Nginx即可。
  • 方式二（按站点/按路径分流）：更灵活的方式是为不同的server块或location块指定不同的fastcgi_pass路径。这样，你就能在同一台服务器上，让不同的应用运行在不同版本的PHP上。
  • 验证：部署一个包含phpinfo()函数的页面进行访问，是确认PHP版本是否切换成功的最直观方法。

五 验证与常见问题处理

配置完成，打开浏览器访问你的域名。如果一切顺利，应该能看到应用界面。如果遇到问题，别慌，按照以下思路排查，十有八九能找到原因。

• 健康检查与日志定位：
  • 访问应用首页或特定的健康检查接口。如果遇到白屏或500错误，请按顺序检查以下日志文件，错误信息通常就在里面：
    • Nginx 错误日志：/var/log/nginx/error.log
    • PHP-FPM 日志：路径可能类似/var/log/php7.4-fpm.log（具体因版本和系统而异）
    • MySQL 错误日志：/var/log/mysql/error.log
• 常见问题速解：
  • 404：首先检查Nginx配置中的root是否指向了应用正确的入口目录（例如Lara vel的public目录）。其次，确认try_files规则是否正确，能够将请求路由到前端控制器（如index.php）。
  • 502/504：这类网关错误，多半是Nginx和PHP-FPM“通信失败”。重点核对两者配置中的socket路径或TCP端口是否一致；检查PHP-FPM进程是否正常运行（systemctl status php7.4-fpm）；确认socket文件的权限是否正确（www-data用户可访问）。
  • 权限问题：牢记一个原则：站点目录的属主建议设为www-data:www-data（或你的Web服务用户）。文件权限644、目录权限755是一个安全的起点，尽量避免使用777这种过于宽松的权限。
  • 数据库连接失败：仔细核对应用配置文件（如.env）中的DB_HOST、DB_USER、DB_PASS、DB_NAME。确保数据库服务已启动，并且创建的用户拥有对应数据库的访问权限。
• 安全与优化建议：
  • 应用上线后，记得删除或重命名测试用的info.php等文件。为你的域名配置HTTPS，现在通过Let’s Encrypt获取免费证书非常方便。最后，可以根据流量情况，在Nginx和PHP中开启Gzip压缩、调整缓冲区与超时设置，进一步提升应用性能与用户体验。