try_files指令的作用是依次尝试匹配请求的uri作为文件、目录，若均不存在则将请求内部重写到index.php，使YII框架能接管路由处理，实现“美观url”；2. 确保yii应用正确处理静态资源和php脚本的方法是：通过root指令指定web目录，使用location ~ .php$块将php请求通过fastcgi_pass转发给php-fpm，并设置fastcgi_param script_filename确保脚本路径正确，同时为静态资源配置独立的location块以启用缓存、关闭日志等优化；3. 常见错误包括root路径错误、php-fpm未运行、try_files缺失、权限不足和script_filename配置错误，性能优化建议包括启用gzip压缩、配置静态文件缓存、优化php-fpm进程设置、启用opcache、合理使用nginx fastcgi缓存、限制日志记录及调整client_max_body_size以支持大文件上传，所有配置修改后需通过nginx -t测试语法并重新加载服务生效。
YII框架的Nginx配置核心在于将所有非文件或非目录的请求重写到
index.php
，由Yii的应用入口文件来接管路由，同时确保Nginx能正确地将PHP脚本请求转发给PHP-FPM处理。这就像是给Yii应用在Nginx上铺设了一条专用的高速公路，让它能顺畅地处理各种请求，无论是访问页面、API还是静态资源。
解决方案
server { listen 80; server_name your_domain.com; # 替换为你的域名或IP地址 root /path/to/your/yii/app/web; # 替换为你的Yii应用web目录的绝对路径 index index.php; # 允许访问隐藏文件，但通常不建议在生产环境直接暴露 # location ~ /.ht { # deny all; # } # 禁止直接访问composer.JSon等敏感文件 location ~* /(protected|framework|config|common|runtime|vendor|console|commands|models|views|controllers|modules|widgets)/ { deny all; } # 处理所有非文件/非目录的请求，将其重写到index.php location / { try_files $uri $uri/ /index.php?$args; } # 将所有.php文件的请求转发给PHP-FPM location ~ .php$ { # 如果你的PHP-FPM是监听unix socket # fastcgi_pass unix:/var/run/php/php-fpm.sock; # 如果你的PHP-FPM是监听TCP端口 fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; include fastcgi_params; # 包含Nginx默认的fastcgi参数 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_param PATH_INFO $fastcgi_path_info; fastcgi_buffer_size 128k; fastcgi_buffers 4 256k; fastcgi_busy_buffers_size 256k; } # 优化静态文件缓存，可以根据实际情况调整缓存时间 location ~* .(js|css|png|jpg|jpeg|gif|ico|svg|eot|ttf|woff|woff2)$ { expires 30d; # 缓存30天 add_header Cache-Control "public, must-revalidate"; Access_log off; # 静态文件访问量大时可以关闭日志 } # 错误页面配置 Error_page 404 /index.php; # 或者自定义的404页面 # error_page 500 502 503 504 /50x.html; # location = /50x.html { # root /usr/share/nginx/html; # } # 开启Gzip压缩，提升传输效率 gzip on; gzip_vary on; gzip_proxied any; gzip_comp_level 6; gzip_buffers 16 8k; gzip_http_version 1.1; gzip_types text/plain text/css application/json application/JavaScript text/xml application/xml application/xml+rss text/javascript; }
YII框架Nginx配置中，
try_files
try_files
指令的作用是什么？
try_files
指令在Nginx的Yii配置中，简直就是核心中的核心，它是实现Yii“美观URL”（Pretty URLs）的关键。你可以把它想象成一个智能的交通警察，当用户请求一个URL时，这个警察会按照你设定的优先级去“尝试”寻找对应的资源。
具体来说，
try_files $uri $uri/ /index.php?$args;
这行配置，它做了三件事：
-
尝试查找文件 (
$uri
): Nginx会首先检查请求的URI（比如
/about/us
）是否直接对应服务器上的一个真实文件（例如，你的
web
目录下是否存在一个名为
about/us
的文件）。如果找到了，就直接返回这个文件。这对于像
robots.txt
、
favicon.ico
这样的静态文件非常有用。
-
尝试查找目录 (
$uri/
): 如果没找到对应的文件，Nginx会接着尝试检查请求的URI是否对应一个真实存在的目录（例如，
web
目录下是否存在一个
about/us
的目录）。如果找到了，并且该目录下有
index.php
（或Nginx配置的
index
文件），它会尝试提供该目录的默认索引文件。在Yii应用中，这个通常不是主路由逻辑，但对某些特定目录访问会有用。
-
回退到
index.php
(
/index.php?$args
): 如果上面两步都失败了，也就是Nginx既没有找到与URI匹配的文件，也没有找到与URI匹配的目录，那么它就会把请求内部重写到
/index.php
。注意，这里是内部重写，而不是浏览器重定向。
?$args
则确保了原始URL中的查询参数（比如
?id=123
）会被完整地传递给
index.php
。
为什么这对Yii至关重要呢？因为Yii框架的URL管理器（
UrlManager
）就是通过解析
index.php
接收到的请求路径来决定调用哪个控制器和动作的。用户访问的
your_domain.com/product/view?id=10
这样的URL，在服务器上并没有一个物理文件叫
product/view
。
try_files
确保了Nginx会把这个请求“交给”
index.php
，然后Yii的URL管理器才能根据配置的路由规则，将
/product/view
解析为
ProductController
的
actionView
方法，并把
id=10
作为参数传递过去。没有
try_files
的正确配置，Nginx可能就直接返回404错误了，因为找不到对应的物理文件。
如何确保Yii应用在Nginx下正确处理静态资源和PHP脚本？
确保Yii应用在Nginx下正确处理静态资源和PHP脚本，这涉及到Nginx配置中的几个关键点，理解它们的工作原理能让你少走很多弯路。
处理PHP脚本的核心在于
location ~ .php$
块和
fastcgi_pass
指令。当Nginx接收到一个以
.php
结尾的请求时，这个
location
块就会被触发。它告诉Nginx：“嘿，这个请求是个PHP脚本，我不能直接处理它，我需要把它转发给一个专门处理PHP的程序。”这个“专门处理PHP的程序”通常就是PHP-FPM（FastCGI Process Manager）。
fastcgi_pass 127.0.0.1:9000;
或
fastcgi_pass unix:/var/run/php/php-fpm.sock;
就是指定PHP-FPM的监听地址和端口（或者Unix socket）。Nginx会把请求的详细信息（比如请求方法、URI、POST数据等）通过FastCGI协议传递给PHP-FPM。PHP-FPM接收到这些信息后，会执行对应的PHP脚本（在Yii中通常是
index.php
），然后把执行结果（HTML、JSON等）再通过FastCGI协议返回给Nginx，Nginx最后再发送给客户端浏览器。
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
这行也至关重要，它告诉PHP-FPM要执行的PHP脚本的完整路径。
$document_root
就是你在
server
块里定义的
root
路径（通常是Yii应用的
web
目录），
$fastcgi_script_name
是请求的PHP文件名。
至于静态资源（如CSS、JavaScript、图片等），它们的处理相对简单直接。Nginx本身就是高性能的静态文件服务器，所以我们希望它能直接处理这些文件，而不要把它们也丢给PHP-FPM。
首先，
root /path/to/your/yii/app/web;
这一行就确定了所有请求的根目录。这意味着Nginx会从这个目录下查找文件。对于静态文件，比如
/css/site.css
，Nginx会直接在
/path/to/your/yii/app/web/css/site.css
这个路径下查找并返回。
为了进一步优化，你可以添加一个专门的
location
块来处理静态文件，就像这样：
location ~* .(js|css|png|jpg|jpeg|gif|ico|svg|eot|ttf|woff|woff2)$ { expires 30d; # 缓存30天 add_header Cache-Control "public, must-revalidate"; access_log off; # 静态文件访问量大时可以关闭日志 }
这个块的作用是：
- *匹配模式 (`~ .(js|css|…)
)**: 它使用正则表达式匹配所有以常见静态文件扩展名结尾的请求。
~*`表示不区分大小写匹配。
- 缓存 (
expires 30d;
)
: 告诉浏览器这些文件可以缓存30天，减少后续请求的服务器压力。 - HTTP头 (
add_header Cache-Control "public, must-revalidate";
)
: 进一步控制浏览器缓存行为。 - 日志 (
access_log off;
)
: 对于频繁访问的静态文件，关闭访问日志可以减少磁盘I/O，提升性能。
通过这样的配置，Nginx能够高效地区分并处理不同类型的请求：PHP脚本交给PHP-FPM，静态文件自己直接返回并进行缓存优化，而那些既不是文件也不是目录的请求则通过
try_files
交给Yii的
index.php
进行路由处理。
Yii框架Nginx配置时，有哪些常见的错误和性能优化建议？
在配置Yii框架的Nginx时，有些坑是大家经常会踩的，同时也有不少方法可以提升性能。
常见错误：
-
root
路径设置错误：这是最常见的，也是最基础的错误。Nginx的
root
指令必须指向Yii应用中的
web
目录（或你自定义的入口目录），而不是Yii项目的根目录。如果指向了项目根目录，Nginx可能会尝试直接访问
protected
、
vendor
等不应该被外部访问的目录，或者找不到
index.php
。
- 表现：页面显示404，或者直接暴露了项目结构。
- 检查：确认
root
指令指向的是
your_app/web
。
-
PHP-FPM未运行或配置不当：Nginx只是个HTTP服务器，它本身不执行PHP代码。它需要把PHP请求转发给PHP-FPM来处理。
-
try_files
指令缺失或错误：没有正确配置
try_files
，Yii的“美观URL”就无法工作。
- 表现：只有
index.php
能访问，其他路由路径都显示404。
- 检查：确保
location / { try_files $uri $uri/ /index.php?$args; }存在且正确。
- 表现：只有
-
文件权限问题：Nginx和PHP-FPM通常以低权限用户（如
www-data
或
nginx
）运行。如果Yii项目目录或
runtime
、
web/assets
目录的权限设置不当，可能导致Nginx无法读取文件，或者Yii无法写入缓存、日志等。
- 表现：500 internal Server Error，日志中显示权限拒绝。
- 检查：确保
storage/web
、
runtime
、
web/assets
目录对Nginx/PHP-FPM的用户有读写权限。
-
fastcgi_param SCRIPT_FILENAME
配置错误：这个参数告诉PHP-FPM哪个文件是主脚本。如果不对，PHP-FPM可能找不到
index.php
。
- 表现：500错误，PHP-FPM日志中可能显示找不到文件。
- 检查：确保
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
正确。
性能优化建议：
-
开启Gzip压缩：在Nginx配置中启用Gzip压缩可以显著减少传输数据量，加快页面加载速度。
gzip on; gzip_vary on; gzip_proxied any; gzip_comp_level 6; # 压缩级别，1-9，6是平衡点 gzip_buffers 16 8k; gzip_http_version 1.1; gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
-
配置静态文件缓存：让浏览器缓存静态资源，减少重复请求。
location ~* .(js|css|png|jpg|jpeg|gif|ico|svg|eot|ttf|woff|woff2)$ { expires 30d; # 缓存30天 add_header Cache-Control "public, must-revalidate"; access_log off; # 静态文件访问量大时可以关闭日志 } -
优化PHP-FPM配置：调整PHP-FPM的进程管理参数（如
pm.max_children
,
pm.start_servers
,
pm.min_spare_servers
,
pm.max_spare_servers
）以适应服务器的内存和CPU资源。
- 检查：PHP-FPM的配置文件，通常在
/etc/php/X.X/fpm/pool.d/www.conf
或类似路径。
- 检查：PHP-FPM的配置文件，通常在
-
使用PHP Opcode Cache：开启PHP的Opcode缓存（如OPcache）可以避免每次请求都重新编译PHP脚本，显著提升PHP执行效率。
- 检查：
php.ini
中
opcache.enable=1
，并调整
opcache.memory_consumption
等参数。
- 检查：
-
Nginx FastCGI缓存：对于不经常变化的动态内容，Nginx可以缓存PHP-FPM的响应，直接返回缓存内容而无需再次请求PHP-FPM。
# 在http块中定义fastcgi_cache_path # http { # fastcgi_cache_path /var/cache/nginx/fastcgi_cache levels=1:2 keys_zone=my_cache:10m inactive=60m; # fastcgi_cache_key "$scheme$request_method$host$request_uri"; # ... # } # 在server块或location块中启用 # location ~ .php$ { # fastcgi_cache my_cache; # fastcgi_cache_valid 200 30m; # 缓存200状态码的响应30分钟 # fastcgi_cache_use_stale error timeout invalid_header http_500; # add_header X-FastCGI-Cache $upstream_cache_status; # 方便调试缓存是否命中 # ... # }这个需要根据实际业务逻辑谨慎使用，因为Yii应用通常是动态的，缓存不当可能导致显示旧数据。
-
限制不必要的日志记录：对于高流量的网站，过多的日志写入会带来I/O开销。对于静态文件可以关闭
access_log
。
-
合理设置
client_max_body_size
：如果你的应用需要上传大文件，Nginx默认的请求体大小限制可能会导致413 Request Entity Too Large错误。
client_max_body_size 20M; # 允许最大20MB的请求体
这个通常放在
http
块或
server
块中。
通过细致地检查和调整这些配置，你的Yii应用在Nginx下会跑得更稳、更快。记住，每次修改Nginx配置后，都要
sudo nginx -t
检查语法，然后
sudo systemctl reload nginx
（或
restart
）来应用更改。
