如何将 Apache 转 Nginx？完整迁移指南

为什么从Apache迁移到Nginx？

Nginx以其高性能、低内存占用和出色的并发处理能力成为现代Web服务器的首选。相比Apache，Nginx在静态内容处理、反向代理和负载均衡方面表现更优异，特别适合高流量网站。

迁移前的准备工作

1. 备份现有Apache配置（httpd.conf和所有虚拟主机文件）
2. 记录当前使用的模块（通过apachectl -M命令）
3. 准备测试环境验证Nginx配置
4. 规划停机窗口或准备渐进式迁移方案

核心配置转换

1. 虚拟主机配置转换

Apache配置示例：

<VirtualHost :80>
    ServerName example.com
    DocumentRoot /var/www/
    ErrorLog /var/log/apache2/error.log
    CustomLog /var/log/apache2/access.log combined
</VirtualHost>

对应的Nginx配置：

server {
    listen 80;
    server_name example.com;
    root /var/www/;
    
    access_log /var/log/nginx/access.log;
    error_log /var/log/nginx/error.log;
    
    location / {
        try_files $uri $uri/ =404;
    }
}

2. URL重写规则转换

Apache的mod_rewrite规则：

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.)$ index.php?q=$1 [L,QSA]

Nginx等效配置：

location / {
    try_files $uri $uri/ /index.php?q=$uri&$args;
}

关键注意事项

1. PHP处理配置

Nginx需要通过FastCGI处理PHP：

location ~ .php$ {
    include fastcgi_params;
    fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}

2. .htaccess文件转换

Nginx不支持.htaccess，需要将所有规则转换到主配置文件中。常见转换包括：

• 认证配置转换为auth_basic指令
• 重定向规则转换为return或rewrite
• 缓存控制头转换为expires指令

3. 性能优化配置

 启用gzip压缩
gzip on;
gzip_types text/plain text/css application/json application/javascript;

 静态文件缓存
location ~ .(jpg|jpeg|png|gif|ico|css|js)$ {
    expires 30d;
    add_header Cache-Control "public, no-transform";
}

迁移后验证步骤

1. 使用nginx -t测试配置语法
2. 逐步转移流量并监控错误日志
3. 验证所有URL路由和重定向
4. 检查PHP应用功能完整性
5. 进行负载测试确认性能提升

常见问题解决方案

通过以上步骤，您可以顺利完成从Apache到Nginx的迁移。建议先在测试环境验证所有配置，再逐步在生产环境实施变更。