Nginx泛解析到子目录后自动判断有无public目录详解

我们大家在配置本地 PHP 开发环境时,除非是在 Windows 下,否则我都是偏向于 Nginx + PHP-FPM, 即使 Mac 下已经有了自带的 Apache+PHP 环境,依然如此。一方面是因为 Mac 自带的 PHP 版本不够新(5.6.x),另一方面,Nginx + PHP-FPM 更接近于我的生产服务器环境,而且也方便用 Homebrew 来管理版本和扩展。

在 Mac 下开发 Laravel, 官方提供了 valet, 可以方便地把子目录映射为虚拟主机,但我在使用的时候,遇到一些问题:

真实错误信息难以追踪,总是报 valet 的 index.php 或者 laravel 的 index.php 错误;

Symfony 框架里的 config.php/app_debug.php 等无法直接访问。

于是我只保留了 dnsmasq 来管理特定后缀的域名(实现自动解析),然后放弃了 valet,自己做了一个泛解析绑定到本地子目录的配置。

具体配置如下(域名是 *.app):

  1. server {
  2. listen 80;
  3. server_name ~^(?<subdomain>.+).app$;
  4. set $root /Users/kairee/Sites/$subdomain;
  5. if ( -d "/Users/kairee/Sites/$subdomain/public") {
  6. set $root /Users/kairee/Sites/$subdomain/public;
  7. }
  8. root $root;
  9. charset utf-8;
  10. client_max_body_size 128M;
  11. index index.php;
  12. location / {
  13. try_files $uri $uri/ /index.php$is_args$args;
  14. }
  15. access_log off;
  16. location ~ \.php\?? {
  17. fastcgi_split_path_info ^(.+\.php)(/.+)$;
  18. fastcgi_pass unix:/tmp/php.sock;
  19. fastcgi_index index.php;
  20. include fastcgi_params;
  21. fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
  22. }
  23. location ~ /\.ht {
  24. deny all;
  25. }
  26. }

采用这个配置以后:

如果存在 ~/Sites/domain/public, 则 domain.app 域名的根目录会指向 ~/Sites/domain/public;

如果存在 ~/Sites/domain 但是不存在 ~/Sites/domain/public, 则 domain.app 域名的根目录会指向 ~/Sites/domain;

网站根目录下真实存在的 php 文件可以直接访问,只有不存在的文件才会通过入口文件(index.php)处理;

如果需要支持其它框架,可以在配置文件中加一条 if 语句实现,比如要支持 symfony 的话,复制一下 if 判断块,把 public 改成 web 即可。

我虽然只是用于 mac/linux, 但实际上 Windows 下当然也是可以的,如果你在 Windows 下也使用 Nginx 的话。