tp5命令行基础介绍
Posted 徐锅的博客
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了tp5命令行基础介绍相关的知识,希望对你有一定的参考价值。
-
- 查看指令
- 生成模块
- 生成文件
- 生成类库映射文件
- 生成路由缓存文件
- 生成数据表字段缓存文件
- 指令扩展示例
- 命令行调试
- 命令行颜色支持
- 调用命令
查看指令
命令行工具需要在命令行下面执行,请先确保你的
php.exe
已经加入了系统环境变量Path
。
应用的命令行入口文件是应用根目录的think
文件,其内容如下:
// 定义项目路径
define(\'APP_PATH\', \'./application/\');
// 加载框架命令行引导文件
require \'./thinkphp/console.php\';
你也可以自定义
think
文件,更改应用目录。
要执行命令,首先进入命令行,并切换当前目录到应用的根目录(也就是think
文件所在目录)下面,执行:
php think
会显示当前支持的所有指令:
>php think
Think Console version 0.1
Usage:
command [options] [arguments]
Options:
-h, --help Display this help message
-V, --version Display this console version
-q, --quiet Do not output any message
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Available commands:
build Build Application Dirs
help Displays help for a command
list Lists commands
make
make:controller Create a new controller class
make:model Create a new model class
optimize
optimize:autoload Optimizes PSR0 and PSR4 packages to be loaded with classmaps too, good for production.
注意
在win10的周年版中运行会出现乱码,请使用
PowerShell
运行。
使用
>php think list
可以获得相同的结果。
如果输入一个不存在的指令,系统会自动搜索相关的指令并提示,例如:
>php think make
会显示
生成模块
下面我们给应用生成一个新的模块test
,首先需要在application
目录下面创建一个build.php
定义文件,文件内容如下:
return [
// 定义test模块的自动生成
\'test\' => [
\'__dir__\' => [\'controller\', \'model\', \'view\'],
\'controller\' => [\'User\', \'UserType\'],
\'model\' => [\'User\', \'UserType\'],
\'view\' => [\'index/index\', \'index/test\'],
],
];
然后在命令行下面,执行:
>php think build
Successed
如果显示Successed则表示生成成功。
注意,命令行指令是区分大小写的,所以如果执行
>php think Build
会报错。
我们可以看到application
目录下面已经生成了一个test
模块目录,包括下面的子目录及文件:
test
├─controller
│ ├─Index.php
│ ├─User.php
│ └─UserType.php
├─model
│ ├─User.php
│ └─UserType.php
├─view
│ └─index
│ ├─index.html
│ └─test.html
├─common.php
└─config.php
接下来,我们可以访问
http://tp5.com/test/
会显示:
我们在build.php
文件中并没有定义Index
控制器,但仍然生成了一个默认的Index
控制器文件以及欢迎页面,这是为了避免模块访问出错。
生成文件
还可以用make
指令单独生成某个应用类库文件,例如:
php think make:controller test/Blog
会自动为test模块生成一个 Blog控制器文件。
注意,默认生成的控制器类是属于资源控制器,并且继承了\\think\\Controller。
如果希望生成一个空的控制器,可以使用
php think make:controller test/Blog --plain
又或者生成一个模型文件
php think make:model test/Blog
生成类库映射文件
在生成类库文件之后,我们强烈建议使用命令行生成类库映射文件,可以提高自动加载的性能,用法如下:
>php think optimize:autoload
执行完毕,会在RUNTIME_PATH
目录下面生成一个classmap.php
文件,包括了系统和应用的所有类库文件的映射列表。
生成路由缓存文件
如果你的应用定义了大量的路由规则,那么建议在实际部署后生成路由缓存文件,可以免去路由注册的开销,从而改善路由的检测效率,用法如下:
>php think optimize:route
执行完毕,会在RUNTIME_PATH
目录下面生成一个route.php
文件,包括了应用的所有路由规则定义列表。
注意
路由缓存文件只会缓存在application/route.php文件中配置和动态注册的路由规则,因此请确保你没有在其它的文件中进行路由的注册。
生成数据表字段缓存文件
如果你希望提高查询的性能,可以通过生成字段缓存来减少查询。用法如下:
>php think optimize:schema
执行完毕,会在RUNTIME_PATH
目录下面创建schema目录,然后在该目录下面按照database.table.php
的文件命名生成数据表字段缓存文件。
也可以指定数据库生成字段缓存(必须有用户权限),例如,下面指定生成demo数据库下面的所有数据表的字段缓存信息。
php think optimize:schema --db demo
还可以读取模块的模型类来生成数据表字段缓存(这个适合多数据库连接的情况),如下:
php think optimize:schema --module index
会读取index模块的模型来生成数据表字段缓存。
注意
如果模型类没有继承think\\Model或者是抽象类的话,不会生成对应模型的字段缓存。
更新数据表字段缓存也是同样的方式,每次执行都会重新生成缓存。如果需要单独更新某个数据表的缓存,可以使用:
php think optimize:schema --table think_user
支持指定数据库名称
php think optimize:schema --table demo.think_user
指令扩展示例
命令行的作用远不止生成文件这么简单,同时应用也可以很方便的扩展自己的指令,我们来扩展一个用于清理缓存目录的指令clear
。
注意
最新版本已经内置
clear
指令了,下面的示例可以直接使用内置的clear
指令进行学习和测试。
首先,我们创建一个指令类 app\\console\\Clear
,内容如下:
<?php
namespace app\\console;
use think\\console\\Command;
use think\\console\\Input;
use think\\console\\input\\Option;
use think\\console\\Output;
class Clear extends Command
{
protected function configure()
{
// 指令配置
$this
->setName(\'clear\')
->addOption(\'path\', \'d\', Option::VALUE_OPTIONAL, \'path to clear\', null)
->setDescription(\'Clear runtime file\');
}
protected function execute(Input $input, Output $output)
{
$path = $input->getOption(\'path\') ?: RUNTIME_PATH;
$files = scandir($path);
if ($files) {
foreach ($files as $file) {
if (\'.\' != $file && \'..\' != $file && is_dir($path . $file)) {
array_map(\'unlink\', glob($path . $file . \'/*.*\'));
} elseif (is_file($path . $file)) {
unlink($path . $file);
}
}
}
$output->writeln("Clear Successed");
}
}
一个合法的指令类,没有固定的目录和命名空间要求,但必须继承
think\\console\\command\\Command
或者其子类,并且定义configure
和execute
两个方法。
然后,在application目录下面的command.php
(如果不存在则创建)文件中添加如下内容:
return [
\'\\app\\console\\Clear\',
];
表示给应用增加一个命令行Clear
指令,我们可以用list
指令来验证是否已经成功注册Clear
指令:
>php think list
运行后如果看到
表示指令注册成功,接下来可以测试下该指令:
>php think clear
Clear Successed
该指令并不会删除目录,仅仅删除目录下面(包括子目录)的文件。
clear
指令还定义了一个--path
参数用于指定目录,下面是一个指定目录删除文件的用法,我们仅仅需要删除日志文件:
>php think clear --path d:\\www\\tp5\\runtime\\log\\
Clear Successed
--path
参数还有一个简化用法-d
>php think clear -d d:\\www\\tp5\\runtime\\log\\
Clear Successed
命令行调试
命令行一旦执行错误,只能看到简单的错误信息,如果需要调试详细的Trace信息,可以使用 -v
参数来显示,例如:
假设Clear指令文件中使用了一个未定义的变量pathp
,那么我们可以使用
>php think clear
我们需要查看具体的Trace信息,可以使用
>php think clear -v
会看到类似下面的错误信息:
命令行颜色支持
为了让命令行工具更加有趣,think
命令行支持颜色输出,并且内置了几种颜色样式,还可以自己自定义颜色样式输出。
windows下面命令行颜色输出支持需要
windows 10.0.10580
以上版本支持
我们添加一个color
指令用于演示颜色输出效果,代码如下:
<?php
namespace app\\console;
use think\\console\\command\\Command;
use think\\console\\Input;
use think\\console\\Output;
use think\\console\\output\\formatter\\Style;
class Color extends Command
{
protected function configure()
{
$this
->setName(\'color\')
->setDescription(\'Show Color text\');
}
protected function execute(Input $input, Output $output)
{
// 输出info样式
$output->writeln("<info>this is info</info>");
// 输出error样式
$output->writeln("<error>this is error</error>");
// 输出comment样式
$output->writeln("<comment>this is comment</comment>");
// 输出question样式
$output->writeln("<question>this is question</question>");
// 输出highlight样式
$output->writeln("<highlight>this is highlight</highlight>");
// 输出warning样式
$output->writeln("<warning>this is warning</warning>");
// 输出混合样式
$output->writeln("this is <info>info</info>, this is <error>error</error>,this is <comment>comment</comment>,this is <question>question</question>,this is <highlight>highlight</highlight>, this is <warning>warning</warning>");
// 自定义输出样式
$output->getFormatter()->setStyle(\'custom\', new Style(\'black\', \'white\'));
$output->writeln("<custom>this is style</custom>");
}
}
command.php
定义修改如下:
return [
\'\\app\\console\\Clear\',
\'\\app\\console\\Color\',
];
然后执行下面的指令:
>php think color
运行后就可以看到:
调用命令
在代码里面可以直接调用执行命令行的某个命令,例如:
namespace app\\index\\controller;
use think\\Console;
class Index
{
public function index()
{
// 调用命令行的指令
$output = Console::call(\'make:model\',[\'index/Blog\']);
return $output->fetch();
}
}
Console::call方法的第一个参数就是指令名称,后面的第二个参数是一个数组,表示调用的参数。
如果我们要创建一个demo
模块的话,应该是:Console::call(\'build\',[\'--module\', \'demo\']);
当访问
http://tp5.com
页面会输出
Model created successfully.
可以在application/index/model/
目录下面发现已经生成了一个Blog
模型文件。
当我们再次刷新页面的话,会看到页面输出
Model already exists!
表示模型已经创建过了,无需再次创建。
使用
Console::call
方法调用指令执行不会看到最终的输出结果,需要使用fetch方法获取输出信息,一旦发生错误,则会抛出异常。
以上是关于tp5命令行基础介绍的主要内容,如果未能解决你的问题,请参考以下文章
TP5报如下的错误 Indirect modification of overloaded element of thinkpaginatorCollection has no effect(代码片段
通过composer 安装 tp5 并通过命令行创建一个控制器
sql [SQL查询片段]用于在命令行或通过R和其他工具使用SQL的快速代码段#tags:sql,R,text processing,命令li