Laravel怎么配置项目子目录运行 _ Laravel Rewrite规则设置方法【技巧】

laravel子目录部署需确保web服务器仅暴露public目录，并正确配置script_name、rewritebase或nginx的alias与重写规则，否则静态资源404或路由失效。

apache下public目录没放对位置，Laravel根本不会启动

很多人把整个Laravel项目直接扔进htdocs或/var/www/html，结果访问时看到的是满屏的文件列表，或者直接报NotFoundhttpException——其实Laravel压根没跑起来。核心问题在于：Web服务器必须只暴露public目录，其余文件（如app、config、vendor）绝不能被外部访问。

正确做法是把public目录内容（含index.php和.htaccess）作为Web根目录；如果只能把项目放在子目录（比如http://localhost/myapp/），那就得让index.php知道它不在根路径上：

• 打开public/index.php，找到require __DIR__.'/../vendor/autoload.php';这一行，在它前面加：

  $_SERVER['SCRIPT_NAME'] = '/myapp/index.php';

• 确保.htaccess在public目录里且已启用（AllowOverride All）
• 不要手动改APP_URL来“凑”子目录，那只会让生成URL出错，真正起作用的是SCRIPT_NAME和重写规则配合

Nginx子目录重写漏掉index.php，路由全404

Nginx不像Apache自动读.htaccess，所有重写逻辑必须显式写进server配置。常见错误是只写了根路径的try_files，一放到子目录（如/myapp/）就失效——因为location /匹配不到/myapp/xxx。

关键点在于用location ^~ /myapp/精确匹配子目录，并把URI重写干净：

• 在server块里加：

  location ^~ /myapp/ {<br>    alias /path/to/your/project/public/;<br>    try_files $uri $uri/ @laravel;<br>}<br><br>location @laravel {<br>    rewrite ^/myapp/(.*)$ /myapp/index.php?/$1 last;<br>}

• alias末尾必须带/，否则文件路径拼接会错位
• 别用root代替alias，否则/myapp/css/app.css会被映射成/path/.../public/myapp/css/app.css（多了一层myapp）
• 重写后的QUERY_STRING要保留?$1，不然Laravel的Request对象拿不到原始路径

Apache .htaccess里RewriteBase不填对，子目录下CSS/js全404

即使Laravel路由能走通，静态资源（css/app.css、js/app.js）仍可能404——这是.htaccess里的RewriteBase没设准。它不是告诉Laravel项目在哪，而是告诉mod_rewrite：“所有重写规则的基准路径是这个”。

假设项目部署在http://example.com/myapp/，那么.htaccess必须明确声明：

• 在public/.htaccess中，RewriteEngine On下面立刻加一行：

  RewriteBase /myapp/

• 注意结尾斜杠不能少，否则/myapp/css/app.css会被错误重写为/myapp/css/app.css → /myapp/index.php/css/app.css
• 如果用php artisan serve本地调试，RewriteBase无效（它只对Apache生效），此时应检查APP_URL是否设为http://localhost:8000/myapp，否则asset()生成的链接还是错的

Laravel APP_URL和asset()函数在子目录下容易误配

APP_URL只影响邮件、通知、API返回的绝对URL生成，不影响路由匹配或重写。但很多人以为改了它就能解决子目录问题，结果反而让asset('css/app.css')输出http://localhost/myapp/css/app.css（正确），却因Web服务器没配好而404——这其实是环境配置和Web服务器配置没对齐。

• 开发时用php artisan serve --host=localhost --port=8000，APP_URL设为http://localhost:8000即可，不用加子目录
• 生产环境部署到子目录，APP_URL必须带子目录路径，例如https://example.com/myapp，否则邮件里的链接会指向根域名
• asset()生成路径是否带子目录，取决于当前请求的base_path()和APP_URL共同作用，但最终能否加载成功，只取决于Web服务器能否把/myapp/css/app.css正确映射到public/css/app.css

子目录部署真正的难点从来不在Laravel代码里，而在Web服务器如何把“用户看到的URL路径”精准翻译成“磁盘上的文件路径”。哪怕index.php能执行，只要中间任何一层（RewriteBase、alias、SCRIPT_NAME）没对齐，就会出现部分请求通、部分404的诡异现象。