ThinkPHP5.1命令行工具的使用方法与技巧-ThinkPHP-PHP中文网

端口被占用时应使用 php think run -p 8080 换端口；自定义命令需在 configure() 中声明参数并手动校验；控制器内调用命令须用 think\console\application 原生方式并设 setrootpath()；build.php 必须放在应用根目录且路径基于 application/。

thinkphp5.1命令行工具的使用方法与技巧

php think run 启动内置服务器时端口被占用怎么办

直接执行 php think run 默认绑定 127.0.0.1:8000，如果该端口已被占用（比如另一个 TP 项目、Python 的 Flask、甚至 Chrome 的某个调试进程），命令会卡住或报错「Address already in use」。

解决方法不是改 hosts 或杀进程，而是用参数指定新端口：

php think run -p 8080 —— 换端口
php think run -H 0.0.0.0 -p 8080 —— 同时允许局域网访问（调试手机端时有用）
php think run --docroot public —— 显式指定文档根目录，避免因目录结构变动导致 404

注意：-H 和 -p 必须紧挨着参数值，中间不能有空格；--docroot 的路径是相对于应用根目录的，不是绝对路径。

自定义命令类里怎么接收和校验参数

很多新手写完 execute() 就直接硬编码逻辑，结果一传参就报 Too many arguments 或取不到值。关键在 configure() 里声明参数结构。

比如要支持 php think sync --type=user --limit=100：

用 $this->addArgument('name', InputArgument::OPTIONAL) 声明位置参数（不带 --）
用 $this->addOption('type', null, InputOption::VALUE_REQUIRED) 声明选项参数（带 --）
在 execute() 中通过 $input->getArgument('name') 或 $input->getOption('type') 取值
校验必须手动做：比如 if (!$input->getOption('type')) { $output->error('--type 参数必填'); return 1; }

别依赖框架自动校验——TP5.1 的 console 组件不提供参数类型/范围验证，全靠你手写判断。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

在控制器里调用命令为什么没输出、也不执行

直接在控制器里写 exec('php think sync') 或 shell_exec() 看似简单，但大概率失败：PHP-FPM 进程权限受限、PATH 环境变量缺失、当前工作目录不是应用根目录。

正确做法是用框架原生调用方式：

引入 think\console\Application
实例化后调用 run()，传入 Input 和 Output 对象

示例：

$input = new \think\console\Input(['sync', '--type=user']);
$output = new \think\console\Output();
$app = new \think\console\Application();
$app->setRootPath($this->app->getAppPath());
$app->run($input, $output);

注意：setRootPath() 必须显式设置，否则命令找不到配置和命令类；Output 对象默认不输出到浏览器，如需返回结果得用 $output->fetch() 捕获字符串。

build.php 批量生成模块时常见路径错误

php think build --module test 能快速建骨架，但如果你把 build.php 放错位置或写错路径规则，生成的目录可能出现在 vendor/ 下、或控制器文件名变成 IndexController.php 而不是预期的 Index.php。

核心约束只有两条：

build.php 必须放在 应用根目录（即含 application/ 和 public/ 的那层），不能放在 application/ 内部
'controller'=>['Index'] 表示生成 Index.php 文件，不是 IndexController.php；若想生成带 Controller 后缀的类，得手动在模板里改，框架不处理命名约定
路径中的 __dir__ 是相对 application/ 的，比如 '__dir__'=>['widget'] 会生成 application/test/widget/，不是 application/test/controller/widget/