Laravel使用Artisan命令行教程

Laravel 的 Artisan 命令行工具是高效开发不可或缺的利器，本文系统讲解了如何在项目根目录下正确调用 php artisan 执行内置命令（如生成模型、控制器、迁移及缓存管理）、通过交互式 TUI 界面降低 CLI 使用门槛、创建与调试自定义命令，以及快速定位和解决“Command not defined”等常见执行失败问题，无论你是刚接触 Laravel 的新手，还是希望提升自动化开发效率的资深开发者，都能从中获得即学即用的实战指南。

如果您在 Laravel 项目中需要执行代码生成、数据库操作或环境管理等任务，但尚未掌握命令行工具的调用方式，则可能是由于未正确启动 Artisan 或未在项目根目录下运行命令。以下是使用 Laravel Artisan 命令行工具的具体方法：

一、确认 Artisan 可用性并查看全部命令

Artisan 是 Laravel 内置的命令行接口，依赖于项目根目录下的 php artisan 可执行文件。运行前必须确保当前终端工作路径为 Laravel 项目根目录（即包含 artisan 文件的目录），否则将提示“command not found”或“no such file or directory”。

1、打开终端，切换至 Laravel 项目根目录：cd /path/to/your/laravel/project

2、执行命令列出所有已注册的 Artisan 命令：php artisan list

3、若需查看某条命令的详细用法与参数说明，运行：php artisan help [command]，例如 php artisan help make:controller

二、执行常用内置命令

Artisan 提供大量开箱即用的命令，覆盖开发全流程。每条命令均支持选项与参数，其结构遵循统一命名规范（如 make:model、migrate），便于识别功能类别。

1、生成 Eloquent 模型类：php artisan make:model Post

2、生成资源控制器（含 CRUD 方法）：php artisan make:controller PostController --resource

3、创建数据库迁移文件：php artisan make:migration create_posts_table

4、执行数据库迁移：php artisan migrate

5、清空应用缓存：php artisan cache:clear

6、重置配置缓存：php artisan config:clear

三、使用交互式 TUI 界面简化操作

对于不熟悉命令语法或希望避免拼写错误的开发者，可借助第三方交互式终端界面工具 artisan-tui，它将所有 Artisan 命令以可视化菜单形式呈现，自动引导参数输入，降低 CLI 使用门槛。

1、在开发环境中安装该工具：composer require --dev artisan-tui

2、安装完成后，在项目根目录执行：php artisan tui

3、使用方向键高亮选择目标命令（如 make:controller），按回车确认

4、根据提示依次输入控制器名称、是否启用资源模式等字段，工具将自动生成并执行完整命令

四、运行自定义 Artisan 命令

自定义命令需满足三个前提：类文件位于 app/Console/Commands/ 目录、继承 Illuminate\Console\Command、定义有效的 $signature 属性。Laravel 8+ 默认启用自动发现机制，无需手动注册；旧版本则需在 app/Console/Kernel.php 的 $commands 数组中显式添加。

1、生成自定义命令骨架：php artisan make:command SendDailyReport

2、编辑生成的文件 app/Console/Commands/SendDailyReport.php，设置 $signature = 'report:send {user}'; 与 $description = 'Send daily report to specified user';

3、在 handle() 方法中编写业务逻辑，例如调用 Eloquent 查询或发送邮件

4、运行命令验证：php artisan report:send admin

五、调试 Artisan 命令执行失败问题

当执行自定义或内置命令时报错 “Command is not defined”，通常并非代码逻辑错误，而是命令未被框架加载或解析。核心排查点集中在自动加载机制、命名空间声明与签名格式是否合规。

1、检查命令类是否位于 app/Console/Commands/ 下，且命名空间为 App\Console\Commands

2、确认 $signature 属性值非空、不含空格及非法字符（如 send:weekly-report 合法，send: weekly report 非法）

3、运行 composer dump-autoload 强制刷新自动加载映射（尤其在移动文件或修改命名空间后）

4、执行 php artisan list，观察目标命令是否出现在输出列表中；未出现即表示注册失败

理论要掌握，实操不能落！以上关于《Laravel使用Artisan命令行教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！