0

0

如何在Laravel中配置路由缓存

畫卷琴夢

畫卷琴夢

发布时间:2025-07-12 16:34:01

|

953人浏览过

|

来源于php中文网

原创

laravel路由缓存通过将路由定义编译为单个php文件来提升性能。1. 它减少了每次请求时解析多个路由文件的开销,适用于生产环境;2. 启用时需先清除旧缓存(php artisan route:clear),再生成新缓存(php artisan route:cache);3. 路由缓存后,修改路由文件不会生效,必须重新生成;4. 闭包路由无法被缓存,应使用控制器方法代替;5. 开发环境不建议启用,影响效率;6. 可集成到部署流程中实现自动化,确保上线后路由始终有效。正确使用可优化应用性能,但需注意适用场景与限制。

如何在Laravel中配置路由缓存

在Laravel应用中,路由缓存是一个提升性能的小技巧。简单来说,它就是把你的路由定义编译成一个PHP文件,这样每次请求过来,Laravel就不用再费力去解析那些散落在各处的路由文件了,直接读取那个编译好的文件,速度自然就快了。配置起来也挺直接的,几个命令的事。

要启用Laravel的路由缓存,你只需要在命令行里敲两个Artisan命令。这操作通常是在你的应用准备上线,也就是部署到生产环境的时候才去做。

如果你的项目之前有过路由缓存,或者你改动了路由文件,最好先清除一下旧的缓存。这能避免一些奇奇怪怪的问题,比如你改了路由却发现没生效,那多半就是缓存搞的鬼。

php artisan route:clear

这个命令会删除掉之前生成的 bootstrap/cache/routes.php 文件。

然后,就是生成新的路由缓存了:

php artisan route:cache

执行完这个命令,Laravel就会把你的所有路由定义编译并保存到 bootstrap/cache/routes.php 这个文件里。之后所有的HTTP请求,路由解析都会直接走这个文件,效率自然就上去了。

不过,这里有个大前提:一旦你生成了路由缓存,你的路由文件就相当于被“冻结”了。如果你之后又去修改了 routes/web.php 或者 routes/api.php 里的内容,这些修改是不会生效的,除非你再次运行 route:clear 清除缓存,然后 route:cache 重新生成。这点在开发的时候尤其要注意,不然你会发现自己改了半天代码,页面行为却一点没变,那感觉真是让人抓狂。所以,一般我们只在生产环境用这招。

Laravel路由缓存到底怎么回事?它真能让我的应用跑得更快吗?

说实话,第一次听说路由缓存,我心里也犯嘀咕,这玩意儿能有多大用?但深入了解后,你会发现它背后的逻辑其实挺简单的,而且效果确实有。

Laravel在处理HTTP请求时,需要知道哪个URL对应哪个控制器方法或者闭包。在没有缓存的情况下,每次请求进来,框架都得去加载 routes 目录下那些PHP文件,解析里面的路由定义,然后构建一个路由映射表。对于一个小型应用,路由文件可能就那么几个,解析起来也快。但如果你的应用路由特别多,比如有上百个甚至上千个路由规则,每次请求都重复这个解析过程,开销就大了。这就像你每次查字典都要从头翻一遍,而不是直接翻到你标记好的那一页。

路由缓存做的,就是把这个“查字典”的过程提前完成了。它把所有路由定义解析一遍,然后把解析结果——一个巨大的PHP数组——序列化后,直接写入到 bootstrap/cache/routes.php 这个文件里。这个文件里存的就是一个纯粹的PHP数组,加载起来非常快,因为省去了大量的PHP文件加载、语法解析、以及路由集合的构建工作。

所以,它确实能提升性能。特别是对于路由数量庞大、并发量高的生产环境,这种优化效果会更明显。它减少了每次请求的I/O操作和CPU消耗,让你的应用在路由匹配这一环节上更快一步。在我看来,它不是那种能让你的应用性能翻倍的“银弹”,但绝对是一个值得做的、成本极低的优化。就像给赛车换了个更轻的轮毂,虽然不是引擎升级,但整体表现肯定更流畅。

跃问视频
跃问视频

阶跃星辰推出的AI视频生成工具

下载

路由缓存有哪些“坑”?什么时候最好别碰它?

任何优化手段都有它的两面性,路由缓存也不例外。用得好是利器,用不好可能就是个“坑”。

最大的一个“坑”,也是最常被提及的,就是闭包路由(Closure Routes)不能被缓存。如果你在 routes/web.php 里写了类似 Route::get('/hello', function() { return 'Hello World'; }); 这样的路由,它就没办法被路由缓存优化。原因很简单,PHP的闭包是匿名函数,它们无法被序列化成一个静态的、可执行的文件。当你尝试缓存包含闭包路由的应用时,Laravel会直接报错。所以,最佳实践是始终将路由指向控制器方法,例如 Route::get('/users', [UserController::class, 'index']);。这不仅是为了路由缓存,也是为了代码的可维护性和结构清晰。我个人在项目中就很少直接用闭包路由,除非是那种临时性的、非常简单的测试路由。

第二个“坑”,就是它不适合在开发环境使用。开发过程中,我们经常需要修改路由文件,比如新增一个接口,调整一个URL路径。如果你启用了路由缓存,每次修改后,你都得手动运行 php artisan route:clearphp artisan route:cache。这操作频繁了,效率就直线下降,简直是在给自己找麻烦。所以,我一般都只在部署到生产环境时才考虑启用它。在 composer.jsonpost-autoload-dump 脚本里或者CI/CD流程中加进去,让它自动化完成,这样就省心多了。

还有一点,路由缓存文件 bootstrap/cache/routes.php 是一个编译后的文件,如果你的服务器环境对文件权限或者PHP的 opcache 有特殊配置,可能会导致这个文件无法被正确生成或加载。虽然这种情况比较少见,但如果遇到路由缓存不生效或者报错,可以从这个角度去排查一下。

总的来说,路由缓存这玩意儿,在生产环境用得好,能让你的应用更“丝滑”。但在开发阶段,它就像个“冻结”按钮,让你不得不频繁地“解冻”和“重冻结”,所以,分清场合很重要。

怎么把路由缓存完美融入我的部署流程?

既然路由缓存主要用于生产环境,那么如何确保它在每次部署时都能正确地生成和更新,就显得尤为重要了。手动执行命令当然可以,但那效率太低,而且容易出错。自动化才是王道。

最常见的做法,就是把 route:clearroute:cache 这两个命令集成到你的部署脚本或者CI/CD流水线中。无论是使用 Capistrano、Deployer 这样的部署工具,还是GitLab CI、GitHub Actions、Jenkins 等持续集成/持续部署平台,你都应该在部署的后期阶段,也就是新代码已经部署到服务器上,并且 composer install 等依赖安装完成后,执行这两个命令。

一个典型的部署步骤可能看起来是这样的:

  1. 拉取最新代码
  2. 安装Composer依赖 (composer install --no-dev --optimize-autoloader)
  3. 运行数据库迁移 (php artisan migrate --force)
  4. 清除旧缓存 (php artisan route:clear)
  5. 生成新路由缓存 (php artisan route:cache)
  6. 生成配置缓存 (php artisan config:cache)
  7. 生成视图缓存 (php artisan view:cache)
  8. 重启PHP-FPM(如果需要)

你看,这两个命令就自然而然地嵌入进去了。这样每次部署,无论你改了多少路由,新的路由缓存都会自动生成,保证你的应用始终运行在最优状态。

我个人在设置CI/CD时,会特别强调这一步。因为很多时候,部署后发现某个新加的路由不工作,或者旧的路由行为异常,第一个想到的就是“是不是忘了清除并重新生成缓存?”。把这个步骤自动化,能省去不少排查问题的时间。这就像是给你的应用做了一次彻底的“路由大扫除”和“路由优化”,确保每次上线都是“干净利落”的。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2594

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1621

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1508

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

952

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1417

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1234

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1447

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1306

2023.11.13

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

23

2026.01.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Laravel---API接口
Laravel---API接口

共7课时 | 0.6万人学习

PHP自制框架
PHP自制框架

共8课时 | 0.6万人学习

PHP面向对象基础课程(更新中)
PHP面向对象基础课程(更新中)

共12课时 | 0.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号