本地如何使用php命令行

本地玩转PHP命令行：从基础到实用技巧**

PHP，作为一种广泛使用的服务器端脚本语言，我们通常将其与Web开发紧密联系在一起，PHP的强大之处远不止于此，其命令行接口（CLI，Command Line Interface）为我们提供了强大的本地脚本执行能力，无论是自动化任务、快速测试代码、管理项目，还是进行系统维护，PHP CLI都能大显身手，本文将详细介绍如何在本地环境中使用PHP命令行,带你解锁PHP的另一种可能。

环境准备：确认PHP CLI已安装并可用

在使用PHP命令行之前，首先需要确保你的系统中已经安装了PHP CLI环境，并且系统能够识别php命令。

检查PHP是否已安装： 打开你的终端（在Windows上是CMD、PowerShell或WSL；在macOS或Linux上是Terminal）,输入以下命令：
```
php -v
```
如果PHP已正确安装,你将看到类似以下的版本信息输出：
```
PHP 8.1.12 (cli) (built: Oct 25 2022 14:11:22) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.1.12, Copyright (c) Zend Technologies
    with Zend OPcache v8.1.12, Copyright (c), by Zend Technologies
```
如果提示'php' 不是内部或外部命令，也不是可运行的程序或批处理文件（Windows）或command not found: php（macOS/Linux），则说明PHP CLI未安装或未添加到系统环境变量中。
安装或配置PHP CLI：
- Windows:
  - 你可以从PHP官方网站下载Windows版本的PHP（选择ZIP包，而非安装程序）。
  - 解压下载的ZIP包到一个目录，例如C:\php。
  - 将C:\php目录添加到系统的PATH环境变量中，这样就可以在任意目录下使用php命令。
- macOS:
  - 使用Homebrew安装最为简单：brew install php。
  - 安装完成后,Homebrew通常会自动处理路径问题。
- Linux (Ubuntu/Debian等):
  - 使用包管理器安装，sudo apt update && sudo apt install php。
  - 安装后，通常php命令就可用。
验证配置： 再次运行php -v，确保能看到版本信息，如果看到的是Apache或Nginx模块的版本（通常包含apache2handler或nginx），而不是cli，则可能需要调整PHP的配置文件（php.ini）或确保使用的是CLI版本的php.ini，在CLI模式下，可以通过以下命令查看当前使用的php.ini文件路径：
```
php --ini
```

PHP命令行的基本使用

执行PHP脚本文件

这是最常见的用法，创建一个以.php为扩展名的脚本文件，例如hello.php如下：

<?php
// hello.php
echo "Hello, PHP Command Line World!\n";
echo "Current time: " . date('Y-m-d H:i:s') . "\n";
?>

然后在终端中，使用php命令执行这个脚本：

php hello.php

输出结果将是：

Hello, PHP Command Line World!
Current time: 2023-10-27 10:30:00

直接在命令行执行PHP代码

除了执行文件，PHP CLI还支持直接在命令行输入PHP代码并执行，这对于快速测试单个表达式或小块代码非常有用，使用php -r选项（r代表run）：

php -r "echo 'Hello from -r option!'; echo PHP_EOL;"

PHP_EOL是一个跨平台的换行符常量，推荐使用,输出：

Hello from -r option!

注意： 当使用-r选项时，如果代码中包含特殊字符（如 , 等）,可能需要根据你的终端进行转义或使用单引号包裹代码。

交互式REPL（Read-Eval-Print Loop）

PHP CLI还提供了一个交互式模式，类似于Python的python或Node.js的node命令，直接输入php命令不加任何参数：

php

你会看到php >提示符，然后就可以逐行输入PHP代码,PHP会立即执行并输出结果：

php > $name = "Alice";
php > echo "Hello, " . $name . "!\n";
Hello, Alice!
php > 2 + 2;
php > 4
php > exit;

输入exit或Ctrl+D（Linux/macOS）或Ctrl+Z然后回车（Windows）可以退出交互模式。

获取PHP信息

与Web环境类似，我们可以使用php -i命令来获取PHP的详细配置信息，这会输出一大段HTML格式的文本（在CLI中通常是纯文本，但可能包含一些HTML标签），如果你只想查看特定配置项，可以结合grep命令：

php -i | grep "memory_limit"

输出可能类似于：

memory_limit => 128M => 128M

检查PHP语法错误

在部署代码前，可以使用php -l（l代表lint）选项来检查PHP文件的语法是否正确：

php -l hello.php

如果语法正确,输出：

No syntax errors detected in hello.php

如果有错误,会指出错误位置和原因：

Parse error: syntax error, unexpected ';' in hello.php on line 3
Errors parsing hello.php

PHP命令行的进阶应用

处理命令行参数

PHP脚本可以通过$argv和$argc全局变量来获取命令行传入的参数。

$argv: 一个数组，包含所有传递给脚本的参数。$argv[0]永远是脚本名称本身。
$argc: 一个整数，表示传递给脚本的参数个数（包括脚本名称）。

创建一个args.php文件：

<?php
// args.php
echo "Script name: " . $argv[0] . PHP_EOL;
echo "Number of arguments: " . $argc . PHP_EOL;
echo "Arguments:" . PHP_EOL;
foreach ($argv as $index => $arg) {
    echo "  [$index] => $arg" . PHP_EOL;
}
?>

执行：

php args.php arg1 arg2 --option=value

输出：

Script name: args.php
Number of arguments: 4
Arguments:
  [0] => args.php
  [1] => arg1
  [2] => arg2
  [3] => --option=value

对于更复杂的参数解析（如短选项-v、长选项--verbose），可以使用PHP内置的getopt()函数，或者引入第三方库如symfony/console（常用于构建命令行工具）。

标准输入（STDIN）、标准输出（STDOUT）和标准错误（STDERR）

PHP CLI可以方便地处理标准输入输出：

STDIN: 文件指针,指向标准输入。
STDOUT: 文件指针,指向标准输出。
STDERR: 文件指针,指向标准错误。

创建一个stdin.php文件：

<?php
// stdin.php
echo "Please enter your name: ";
$name = trim(fgets(STDIN)); // 从标准读取一行输入
echo "Hello, $name!" . PHP_EOL;
// 写入标准错误
fwrite(STDERR, "This is an error message." . PHP_EOL);
?>

执行并交互：

php stdin.php
Please enter your name: Bob
Hello, Bob!
This is an error message.

执行远程PHP文件

PHP CLI支持直接执行URL中的PHP代码（需要PHP配置中allow_url_include为On，且服务器允许）：

php -r "include 'http://example.com/some_script.php';"

注意： 此功能存在安全风险,请确保你信任的URL。

后台执行与任务调度

对于需要长时间运行或定期执行的任务,可以将PHP脚本作为后台任务运行。

Linux/macOS:
```
nohup php long_running_script.php > output.log 2>&1 &
```
nohup表示忽略挂起信号，&表示后台运行，> output.log 2>&1将输出重定向到文件。
使用任务调度器： 在Linux上可以使用cron来定期执行PHP脚本：
```
# 编辑crontab
cr
```