PHP框架在Nginx/Apache上出现路由异常或404，主因是未适配单入口机制；需分别配置重写规则、root/DocumentRoot指向public目录、PATH_INFO支持、环境变量透传及SELinux权限。
如果您正在使用PHP框架开发Web应用，但发现其在Nginx或Apache服务器上无法正常路由、静态资源加载失败或出现404错误，则很可能是Web服务器未针对PHP框架的单入口机制（如index.php）进行适配配置。以下是针对两种主流Web服务器的具体配置方法：
一、Nginx下配置PHP框架（以Laravel为例）
Nginx本身不支持.htaccess，需在server块中显式定义重写规则，将所有非静态资源请求统一转发至index.php，由框架内核接管路由分发。
1、打开站点对应的Nginx配置文件（通常位于/etc/nginx/sites-available/your-site或/usr/local/nginx/conf/vhost/your-site.conf）。
2、在location /块中添加try_files $uri $uri/ /index.php?$query_string;指令，确保请求优先匹配真实文件或目录，否则交由index.php处理。
立即学习“PHP免费学习笔记（深入）”；
3、确认已存在针对.php后缀的fastcgi_pass配置，且fastcgi_param SCRIPT_FILENAME指向$realpath_root$fastcgi_script_name，避免因符号链接导致路径解析错误。
4、检查root指令是否指向框架的public/目录（例如root /var/www/myapp/public;），严禁将root设置为项目根目录，否则可能暴露.env等敏感文件。
5、执行sudo nginx -t验证语法，无误后运行sudo systemctl reload nginx生效配置。
二、Apache下配置PHP框架（以Symfony为例）
Apache通过启用mod_rewrite模块及正确设置DocumentRoot与. htaccess规则，实现前端控制器模式，使所有请求经由app.php或index.php统一调度。
1、确保mod_rewrite已启用：运行a2enmod rewrite并重启Apache服务。
2、在虚拟主机配置中将DocumentRoot设为框架的public/子目录（例如DocumentRoot /var/www/myapp/public）。
3、在<directory></directory>块内设置AllowOverride All，允许.htaccess文件生效；同时将Require all granted置于同一作用域。
4、确认public/.htaccess文件存在且内容包含标准重写规则，例如以RewriteRule ^(.*)$ app.php [QSA,L]结尾的完整规则集。
5、若Apache版本≥2.4且启用了MPM Event，需额外确认php-fpm已正确关联，禁用mod_php以避免与FastCGI冲突。
三、Nginx通用兼容配置（适配CodeIgniter、ThinkPHP等）
部分框架依赖PATH_INFO传递路由参数，Nginx默认不自动填充该变量，需手动注入fastcgi_param以保障$_SERVER['PATH_INFO']可用。
1、在server块的location ~ \.php$ {}内部，添加fastcgi_split_path_info ^(.+\.php)(/.+)$;语句分离脚本路径与路径信息。
2、紧接着添加fastcgi_param PATH_INFO $fastcgi_path_info;，确保框架能正确解析URI中的路由段。
3、修改fastcgi_param SCRIPT_FILENAME为$document_root$fastcgi_script_name;，避免使用$realpath_root导致PATH_INFO失效。
4、对于ThinkPHP 6，默认使用public/index.php入口，需将try_files语句改为try_files $uri $uri/ /index.php?$query_string;。
5、若框架要求隐藏index.php但URL仍显示，检查是否遗漏了fastcgi_param SCRIPT_NAME /index.php;这一行。
四、Apache多环境适配配置（开发/生产切换）
通过Apache的SetEnvIf与SetEnv指令，可在不修改PHP代码的前提下，依据Host头或路径前缀动态设定APP_ENV变量，驱动框架加载对应配置。
1、在虚拟主机配置顶部添加SetEnvIf Host "dev\.example\.com" APP_ENV=development，匹配开发域名。
2、添加SetEnvIf Request_URI "^/staging/" APP_ENV=staging，对/staging/路径下的请求强制设为staging环境。
3、在<directory></directory>块内加入SetEnv APP_DEBUG true仅对本地IP开放调试模式。
4、确保框架启动文件（如index.php）中调用getenv('APP_ENV')而非硬编码环境标识。
5、Apache中SetEnv定义的变量默认不传递给CGI/FastCGI进程，必须配合PassEnv或FcgidInitialEnv显式透传。
五、权限与SELinux附加配置（Linux生产环境）
在CentOS/RHEL系统中，即使Nginx或Apache配置语法正确，也可能因文件权限或SELinux策略阻止PHP进程读取框架文件或写入storage/logs目录。
1、执行chown -R www-data:www-data /var/www/myapp（Debian系）或chown -R nginx:nginx /var/www/myapp（RHEL系），确保Web服务器用户拥有项目目录所有权。
2、对bootstrap/cache和storage目录运行chmod -R 775，并设置setgid位：chmod g+s storage bootstrap/cache，保证新创建文件继承组权限。
3、若启用SELinux，执行chcon -R -t httpd_sys_rw_content_t /var/www/myapp/storage和chcon -R -t httpd_sys_rw_content_t /var/www/myapp/bootstrap/cache。
4、临时验证SELinux影响：运行setenforce 0，若此时功能恢复，则确认为策略限制，需保留setsebool -P httpd_can_network_connect 1以允许PHP发起外部HTTP请求。
5、禁止直接关闭SELinux，应使用audit2why分析/var/log/audit/audit.log中avc拒绝日志，生成精准策略模块。
