在学习 Laravel 的时候,可能很多人接触的第一个 artisan 的命令就是:php artisan serve,这样我们就可以跑起第一个 Laravel 的应用。本文来尝试解读一下这个命令行的源码。
代码在哪
跟之前的源码解读文章一样,我推荐大家可以使用编辑器的搜索功能,直接搜ServeCommand 就可以直接打开这个命令的源码文件,位于 Illuminate\Foundation\Console\ServeCommand,像其他的 artisan 命令一样,我们还是关注 fire() 方法:
public function fire(){
chdir($this->laravel->publicPath());
$this->line("
<info>Laravel development server started:</info>
<http://{$this->host()}:{$this->port()}>");
passthru($this->serverCommand());
}
第一步
首先使用 chdir() 将目录改变至 public/ 目录,这是根据 $this->laravel->publicPath() 代码的 publicPath() 来的,这个方法的源码位于 Illuminate\Foundation\Application 中:
public function publicPath(){
return $this->basePath.DIRECTORY_SEPARATOR.'public';
}
上面的 $this->basePath 就是项目的根目录啦!
第二步
打印信息,这是通过 fire() 的第二行代码实现的:
$this->line("
<info>Laravel development server started:</info>
<http://{$this->host()}:{$this->port()}>
");
具体效果就是这样:
第三步
执行命令,这个命令是从 passthru($this->serverCommand()) 的原生函数 passthru() 来实现的,其中 $this->serverCommand() 负责返回一个可以执行的字符串命令,具体代码就在同文件的 serverCommand() 中:
protected function serverCommand(){
return sprintf('%s -S %s:%s %s/server.php',
ProcessUtils::escapeArgument((new PhpExecutableFinder)->find(false)),
$this->host(),
$this->port(),
ProcessUtils::escapeArgument($this->laravel->basePath())
);
}
sprintf() 的四个字符串占位符会被后面传入的四个参数替换,最终打印出一个可以执行的 PHP 命令,其中这四个分别对应的是:
1.下面代码返回 php 的可执行全路径,
ProcessUtils::escapeArgument((new PhpExecutableFinder)->find(false))
2.下面代码返回 host ,默认为 127.0.0.1
$this->host()
这部分可以直接查看 host() 方法:
protected function host(){
return $this->input->getOption('host');
}
这样看来,我们在使用 serve 命令的时候其实是可以传入 host 参数的。
3.下面代码返回 port ,跟 host 是一模一样的:
$this->port()
代码就在 port() 方法中,(使用 serve 命令的时候也是可以直接传入端口号的!):
protected function port(){
return $this->input->getOption('port');
}
上面的 2 和 3 可以直接这样考证 : 执行php artisan help serve
4.下面的代码返回执行代码的全路径:
ProcessUtils::escapeArgument($this->laravel->basePath())
所以,最后 serverCommand() 返回的是什么呢?我们可以直接打印看看:
打印的结果是:
这样一看,php artisan serve 命令就是直接使用 php 执行 server.php 文件,这个文件就在项目的根目录下,比如就是相当于我们直接在命令行执行下面这个命令:
php -S 127.0.0.1:8000 server.php
在这基础上,记得指定 public/ 为网站根目录。
最后
php artisan serve 命令背后其实也就是使用了 php 去直接执行文件,跟我们在使用 php -S php -S 127.0.0.1:8000 PHP 的内置服务器没有太大的区别。