artisan命令必须在laravel项目根目录执行,确认路径正确后运行php artisan list查看命令;自定义命令需注册到kernel.php或满足laravel 10+自动发现条件,并注意$signature中空格与等号位置。

刚装好 Laravel,别急着写代码——先确保环境跑得稳、配置写得对、命令用得熟。安装只是起点,真正影响后续开发效率的,是 .env 的规范设置和 Artisan 的日常使用。
.env 文件必须配对且及时生效
项目根目录下没有 .env 文件,Laravel 就无法读取数据库、调试开关、应用密钥等关键参数。它不是可选配置,而是运行前提。
- 从 .env.example 复制一份,重命名为 .env(注意 Windows 资源管理器可能隐藏扩展名,建议用命令行或编辑器直接新建)
- 至少确认这几项已按需修改:
APP_NAME(项目名称,如 MyAdmin)
APP_DEBUG(开发设为true,生产必须为false)
DB_CONNECTION(选mysql或sqlite;若选 mysql,务必填全DB_HOST、DB_DATABASE、DB_USERNAME、DB_PASSWORD) - 改完立即执行
php artisan config:clear,否则缓存会沿用旧值,导致配置“不生效”的假象
APP_KEY 不是随便生成,而是启动必需
安装后首次运行前,必须执行 php artisan key:generate。这个密钥用于加密 session、cookie 和其他敏感数据,框架启动时会校验它是否存在且格式合法。
- 如果跳过这步,访问页面大概率报错 “No application encryption key has been specified”
- 生成后自动写入 .env 的
APP_KEY行,不要手动修改该值(除非密钥泄露) - 若用 Git 管理项目,确保
.env不提交,但.env.example要提交——它是团队成员初始化配置的模板
Artisan 是日常操作的核心入口
它不只是“启动服务器”的工具,更是贯穿开发、调试、部署全流程的命令中枢。掌握高频命令,能省下大量重复操作时间。
-
php artisan serve:启动本地开发服务器,默认http://localhost:8000;端口被占就加参数,比如--port=8080 -
php artisan migrate:执行数据库迁移(建表),首次部署必跑;加--seed可同步填充测试数据 -
php artisan make:controller UserController:快速生成控制器骨架,带命名空间和基础方法 -
php artisan tinker:进入交互式 PHP 环境,可实时调用模型、查数据库、测试逻辑,比写临时路由高效得多 -
php artisan down/php artisan up:上线维护时切换 503 页面,不影响后台任务运行
环境变量加载有优先级,别被缓存“骗”了
Laravel 启动时按顺序加载环境变量:系统级环境变量 → .env 文件 → 配置文件中硬编码的默认值。一旦配置被缓存(如运行过 php artisan config:cache),.env 修改就不再生效。
- 开发阶段尽量不用
config:cache,避免反复清缓存干扰节奏 - 生产环境部署后,才应运行
php artisan config:cache和php artisan route:cache提升性能 - 检查当前生效的 APP_ENV 值,可执行
php artisan tinker后输入echo config('app.env');











