目录
?
CLI PHP 的优点
安装
PHP 调试
使用 CLI 定位并修正错误
清单 1. 再次运行结果
PHP I/O 通道
STDOUT:echo、print、STDOUT 和 php://stdout
STDERR:STDERR 和 php://stderr
STDIN:STDIN 和 php://stdin
第一个 PHP shell 脚本
清单 2. randomize-lines
命令行参数
清单 3. randomize-lines-w-args
结束语
参考资料
学习
获得产品和技术
讨论
首页 后端开发 php教程 PHP 命令行?是的,您可以

PHP 命令行?是的,您可以

Jun 13, 2016 am 11:38 AM
cli output php

PHP 命令行?是的,您可以!

将 PHP 用于一般目的的脚本并将命令行接口用于 PHP 调试

了解如何通过命令行调试 PHP 代码,以及体验 PHP 本身作为 shell 脚本语言的强大之处。

?

CLI PHP 的优点

多年以来,我一直都在应用不确定的工程师职责定义。我个人认为,工程师就是使用工具来实现与该工具最初开发目的无关的功能。虽然这种想法并不总是正确,但当您认真考虑它时,将发现大多数创新和发明确实来自于通过以前从未考虑过的方法使用工具。

?

想象一下我是多么惊讶,然后,我忽然想到一个主意:使用我的老朋友 PHP,作为命令行工具,它对于 Web 页面来说一直都非常可靠。我绝对不是这样做的第一人,但是这对我来说的确是全新的想法。

?

当然,只是可以 在命令行中使用 PHP 当然不是这样做的最佳理由。但是,您在第一次开始以这种方式用 PHP 进行试验时可能很快就会发现几个令人兴奋的惊喜。首先,调试现有脚本将变得前所未有地简单。由主要输出和极少逻辑组成的 PHP 程序都将变得令人难以置信地简单。除此之外,您还可以使用所有 PHP 知识来完成以前从未想过使用 PHP 完成的任务。事实上,确实没有任何事能阻止您使用 PHP 作为几乎所有给定编程项目的全能王。

?

产生兴趣了?很好,让我们开始着手并看看您可以在命令行中使用 PHP 来完成哪些任务。

?

安装

安装十分简单扼要,它甚至可能都不需要特别安装任何内容。开始时先在命令行中尝试一个简单的 PHP 脚本。您可以使用现有 PHP 脚本,也可以尝试使用以下代码。本例是基于 Linux? 的,但是类似的原理也适用于其他系统。

?

首先,确认 PHP 可执行文件的位置 —— 对于大多数 Linux 系统,几乎肯定是 /usr/bin/php。如果不确定其位置,请在命令行中键入 which php 并查看响应内容。

?

其次,键入以下代码,确保将 /usr/bin/php 替换为 PHP 可执行文件的实际路径。

#!/usr/bin/php -qHello world
登录后复制

?

保存文件并确保用可执行权限做了标记。在大多数系统中,您都可以用 chmod +x hello-world 或类似代码完成此操作。然后,执行 PHP 文件(通过运行 ./hello-world 或者,如果有必要,运行 php hello-world),并查看它是否运行。如果它运行,则安装的 PHP 在默认情况下会包括命令行功能。

如 果代码未能正确运行,事情可能会变得有点儿麻烦。关于原因有很多种不同的可能性。如果您得到一个与 PHP 相关的错误(除了 “未找到程序” 之类的结果),则问题是代码中的输入错误。如果未找到 PHP 可执行文件,请确保您使用了正确的路径。如果没有名为 PHP 的可执行文件,则必须获得一个。

?

获得 PHP 可执行文件可能根据所在系统的不同采取不同的步骤,但是获得所需支持不应当太难。您可以从查阅针对特定操作系统或发行版的文档开始。

?

很明显,如果这时系统中未安装 PHP,则先安装 PHP,然后再次尝试执行以上代码。对于许多系统,安装 PHP 是您需要做的全部操作。如果需要执行更多操作,有时只需使用您最喜欢的包管理工具(例如 apt-getyum)获得 PHP CLI 包(名称可能略有不同)就可以解决此问题。

?

如果在 PHP 包管理工具中未能找到命令行,最糟糕的情况是您可以用 --enable-cli 标记重新编译 PHP。事实上,这样做的优点是提供了稍微优化了的系统并且不管怎么说都不是个坏主意。无论采用哪种方式,开始使用它都不应当太难。

?

到 现在,您应当已经运行了 HelloWorld 脚本,并且输出就是可能已经猜测到的结果。我不会详细说明该脚本的工作原理,但是使用过 shell 脚本和 PHP 的人应当十分熟悉脚本的大部分内容。由于这第一个脚本现在的运行没有出现任何问题(我们希望如此!),因此我们将略微偏离真正的命令行接口 (CLI) 应用程序,看一看为什么在命令行中使用 PHP 对于所有 PHP 程序员来说都是最佳选择的好理由:调试。

?

PHP 调试

可能只有我有这种体验,但是我经常发现调试 CLI 程序会演变成一场噩梦,尤其是处理嵌入了 HTML 的脚本,例如 Microsoft? Active Server Pages (ASP) 或 PHP。通常很难判断特定错误消息所表达的精确含义,用户输入可能很难再次生成,并且整件事通常会使您头痛的希望拔光头发。

?

不幸的是,虽然 足够聪明的程序员可以找到 CLI 能够有所帮助的方法(例如,通过从文件读取输入或通过一个通道的另一个程序),但是大部分问题都不会由于使用命令行而显著减弱。不过,CLI 确实使一件事变得更加简单:找到错误消息,以便可以在第一位置读取这些错误消息。

?

为了查看使用命令行调试的值,让我们从下面所示的非常非常糟糕的 PHP 文件开始。

#!/usr/bin/php -qDon<'t>code<?php while drunk(); ?<
登录后复制

?

虽然第一眼看到代码时,就发现这个脚本中的一些错误十分明显,但是代码在 Web 浏览器中提供了无用调试信息的极好示例。尤其是,不会发生这种情况:在 Apache 中运行此页面只是得到了根本没有输出的结果。如果错误不明显,那么您怎样找到错误原因?

?

解决这个问题的传统方法是查看错误日志。例如,您可能先运行:

tail -f /var/log/httpd/error_log
登录后复制

?

然后再将页面装入运行 Apache 2 的 Linux 系统,这将得到诸如下面的输出:

[client 127.0.0.1] PHP Parse error:  parse error, unexpected T_STRING, expecting     '(' in /var/www/html/dont-code-drunk.php on line 2
登录后复制

?

不幸的是,您可能同意我的观点,考虑这种不太理想的解决方案。一方面,文件日志位置可能因系统的不同而有所不同。另一方面,您必须浏览不相关事件的日志以查找所需内容,这对于活动的服务器来说很可能是一场噩梦。

?

此时,您可能和我曾经想的一样:一定会有更好的方法。

?

使用 CLI 定位并修正错误

通过直接在 CLI 上运行脚本,可以轻松地分离出代码中存在的问题。运行:

php dont-code-drunk.php
登录后复制

?

结果,可能会得到以下输出:

PHP Parse error:  parse error, unexpected T_STRING, expecting     '(' in /var/www/html/dont-code-drunk.php on line 2Content-type: text/htmlX-Powered-By: PHP/4.3.11
登录后复制

?

更棒了!错误消息已与其他数据分离,并且在做出更改后可以轻松地重新查看页面。在这种情况下,很清楚它在行中某个位置需要 '('while 语句看似适合用在这里,因此添加一组新括号,得到以下源代码。

#!/usr/bin/php -qDon<'t>code<?php while (drunk()); ?<
登录后复制

?

现在,再次运行代码将得到以下输出:

?
清单 1. 再次运行结果
Content-type: text/htmlX-Powered-By: PHP/4.3.11<'t>codePHP Fatal error:  Call to undefined function:    drunk() in /var/www/html/dont-code-drunk.php on line 2
登录后复制

?

脚本仍有很多问题,但是您已经取得了一些进展。您已经相对轻松地提取到了所需的错误消息,使您可以快速修正程序中的问题并继续处理下一个问题。

?

全然使用 PHP 的任何人都可以以这种方式充分利用 CLI PHP 进行调试。但是为什么不进一步伸展您自己并开始用 PHP 真正实现 shell 脚本?向前迈进,并且您将会看到将 PHP 用于简单或者不那么简单的 shell 脚本的一些可能性。

?

PHP I/O 通道

为第一个 PHP 脚本制定一个简单的初始目标:创建一个能读入文件并打乱该文件中各行的脚本。如果要打乱 m3u 文件或类似内容,则使用此功能可能很便利。这样做意味着您必须能够从文件或标准输入读取数据并将数据写回终端。

?

这将出现 PHP 中的第一大挑战。PHP 最初不是设计用于与用户直接的键盘输入或文本输出结合使用。了解这一设计是至关重要的,因为如果需要在命令行中执行任何操作,都必须能够与用户来回通信。在诸如 C 之类的传统编程语言中,您将使用 STDINSTDOUTSTDERR 完成此操作。您可以将 PHP 中的相同通道分别用于输入、标准输出和输出到错误通道。

?

STDOUT:echo、print、STDOUT 和 php://stdout

即 使 PHP 设计用于输出到浏览器而不是输出到 CLI,从 PHP 创建输出也是非常简单的,它几乎不需要花太多时间思考。记住,PHP 标记外的任何内容都将被直接输出到 CLI,这就是上面的 HelloWorld 程序如此简单的原因。这也是为什么先输出上面的 Don<'t>code 后再输出错误消息的原因。您是否用 HTML 标记圈起文字都没有关系;因为不管怎样都会显示这些文字。事实上,您通常需要避免使用 HTML 标记,因为它们都将直接打印给用户。

?

您还可以使用基本函数进行输出。例如,echoprint 命令打印到标准输出。

#!/usr/bin/php -qOutput #1.<?php echo "Output #2.";print "Output #3."?>
登录后复制

?

这将得到:

Output #1.Output #2.Output #3.
登录后复制

?

注:PHP 标记外的新行已被输出,但是 echo 命令或 print 命令中没有暗含的新行。事实上,命令提示符重新出现在 Output #2.Output #3. 所在的行中。PHP 拥有的任何其他打印函数将会像此函数一样运行正常,任何写回文件的函数也是一样的。

#!/usr/bin/php -q<?php        $STDOUT = fopen("php://stdout", "w");        fwrite($STDOUT, "Output #1.");        fclose($STDOUT);?>
登录后复制

?

以上代码将把 php://stdout 作为输出通道显式打开,并且 php://output 通常以与 php://stdout 相同的方法运行。最新版本的 PHP 可以使用 STDOUT 作为常量而不是定义上面使用的变量 $STDOUT

?

STDERR:STDERR 和 php://stderr

STDERRSTDOUT 十分接近。用于写入此通道的所有技术将镜像 STDOUT 的那些技术,惟一的差别是您将打开 php://stderr 而不是 php://stdoutphp://error

?

STDIN:STDIN 和 php://stdin

STDIN 是从 Web 编程而来的最有趣更改,因为它向您展示了真正的用户输入而不是使用表单或其他基于浏览器的方法。尝试以下命令:

#!/usr/bin/php -q<?php        $file = file_get_contents("php://stdin", "r");        echo $file;?>
登录后复制

?

这段代码的工作原理应当很像 cat,回转提供给它的所有输入。但是,这时它还不能接受参数。

?

第一个 PHP shell 脚本

很好 —— 从这里开始事情会变得非常有趣。运用到目前为止学到的简单知识,您可以创建简单而有用的 shell 脚本。在文本编辑器中键入以下代码。

?
清单 2. randomize-lines
#!/usr/bin/php -q<?php        $lines = split("\n", file_get_contents("php://stdin", "r"));        shuffle($lines);        foreach ($lines as $line) {                if ($line !== "") {                        echo "$line\n";                }        }?>
登录后复制

?

现在,只需一些快速检查即可运行这个脚本:

  1. 确保 hashbang(第一行,以 #! 开头)被设为先前描述的 PHP 可执行文件的位置
  2. 保存文件
  3. 使用 chmod 添加可执行权限
  4. 运行程序

注:randomize-lines 将完全执行所期望的操作:它打乱键入的输入内容行并将它们以不同的顺序返回回来。这项功能可以颇具价值地填补 shell 脚本库中的空白。

?

作为此脚本的应用程序示例,您可以使用它为音乐或视频播放器动态生成随机播放列表。例如,要打乱 XMMS 播放列表,请尝试:

./randomize-lines < .xmms/xmms.m3u > tempmv temp .xmms/xmms.m3u
登录后复制

?

现在,再升一级。

?

命令行参数

实际命令行程序使用参数。同样,就像 C 语言和其他类似语言一样,您可以为此目的而使用 argvargc。特别是,argv 是程序的参数数组,第一个参数是程序本身。使用这个函数,构建根据给定参数从文件或用户输入读取数据的程序就不难了。例如,请查看以下代码。

?
清单 3. randomize-lines-w-args
#!/usr/bin/php -q<?php        array_shift($argv);        if (count($argv) == 0) {                $argv[0] = "php://stdin";        }        foreach ($argv as $file) {                $lines = split("\n", file_get_contents($file, "r"));                shuffle($lines);                foreach ($lines as $line) {                        if ($line !== "") {                                echo "$line\n";                        }                }        }?>
登录后复制

?

现在您拥有这样一个程序:完全运行的 CLI PHP 程序,它可以接受用户输入,也可以接受文件列表并随机排列每个文件的相关内容。

?

结束语

工欲善其事,必先利其器;但是记住:最佳工具通常都不是您期望使用的那一个工具。请给 PHP 一个机会,在命令行接口中使用它,您就会发现它已经成为您的 shell 脚本工具新宠。最糟糕的情况是:它可以省去一些 Web 服务器麻烦。

?

参考资料

学习

  • 您可以参阅本文在 developerWorks 全球站点上的 英文原文 。
  • 阅读 “PHP by example” 发现 PHP 用于构建复杂且功能强大的 Web 相关程序的简单方法。
  • PHP Freaks 讨论了如何在 CLI 上使用 PHP。
  • PHP CLI 拥有它自己的 Web 站点。谁知道?
  • PHP.net 是 PHP 开发人员的资源。
  • 查阅 “PHP 推荐读物列表”。
  • 浏览 developerWorks 上所有的 PHP 文章 和 PHP 教程。
  • 查阅 IBM developerWorks 的 PHP 项目资源中心 扩展 PHP 技巧。
  • 要收听针对软件开发人员的有趣访谈和讨论,一定要访问 developerWorks podcast。
  • 随时关注 developerWorks 的 技术事件和网络广播。
  • 查阅最近将在全球举办的面向 IBM 开放源码开发人员的研讨会、交易展览、网络广播和其他 活动。
  • 访问 developerWorks 开源软件技术专区,获得丰富的 how-to 信息、工具和项目更新,帮助您用开放源码技术进行开发,并与 IBM 产品结合使用。
  • 访问 Safari 在线书店 浏览开放源码技术的各种参考资料。

获得产品和技术

  • 使用 IBM 试用软件 构建您的下一个开发项目,这些软件可以通过下载或从 DVD 中获得。

讨论

  • 参与 developerWorks blog,加入 developerWorks 社区。
  • 参与 developerWorks PHP 开发者论坛。

来源:http://www.ibm.com/developerworks/cn/opensource/os-php-command/

?

?

?

?

?

?

?

?

?

本站声明
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热AI工具

Undresser.AI Undress

Undresser.AI Undress

人工智能驱动的应用程序,用于创建逼真的裸体照片

AI Clothes Remover

AI Clothes Remover

用于从照片中去除衣服的在线人工智能工具。

Undress AI Tool

Undress AI Tool

免费脱衣服图片

Clothoff.io

Clothoff.io

AI脱衣机

Video Face Swap

Video Face Swap

使用我们完全免费的人工智能换脸工具轻松在任何视频中换脸!

热工具

记事本++7.3.1

记事本++7.3.1

好用且免费的代码编辑器

SublimeText3汉化版

SublimeText3汉化版

中文版,非常好用

禅工作室 13.0.1

禅工作室 13.0.1

功能强大的PHP集成开发环境

Dreamweaver CS6

Dreamweaver CS6

视觉化网页开发工具

SublimeText3 Mac版

SublimeText3 Mac版

神级代码编辑软件(SublimeText3)

适用于 Ubuntu 和 Debian 的 PHP 8.4 安装和升级指南 适用于 Ubuntu 和 Debian 的 PHP 8.4 安装和升级指南 Dec 24, 2024 pm 04:42 PM

PHP 8.4 带来了多项新功能、安全性改进和性能改进,同时弃用和删除了大量功能。 本指南介绍了如何在 Ubuntu、Debian 或其衍生版本上安装 PHP 8.4 或升级到 PHP 8.4

我后悔之前不知道的 7 个 PHP 函数 我后悔之前不知道的 7 个 PHP 函数 Nov 13, 2024 am 09:42 AM

如果您是一位经验丰富的 PHP 开发人员,您可能会感觉您已经在那里并且已经完成了。您已经开发了大量的应用程序,调试了数百万行代码,并调整了一堆脚本来实现操作

如何设置 Visual Studio Code (VS Code) 进行 PHP 开发 如何设置 Visual Studio Code (VS Code) 进行 PHP 开发 Dec 20, 2024 am 11:31 AM

Visual Studio Code,也称为 VS Code,是一个免费的源代码编辑器 - 或集成开发环境 (IDE) - 可用于所有主要操作系统。 VS Code 拥有针对多种编程语言的大量扩展,可以轻松编写

在PHP API中说明JSON Web令牌(JWT)及其用例。 在PHP API中说明JSON Web令牌(JWT)及其用例。 Apr 05, 2025 am 12:04 AM

JWT是一种基于JSON的开放标准,用于在各方之间安全地传输信息,主要用于身份验证和信息交换。1.JWT由Header、Payload和Signature三部分组成。2.JWT的工作原理包括生成JWT、验证JWT和解析Payload三个步骤。3.在PHP中使用JWT进行身份验证时,可以生成和验证JWT,并在高级用法中包含用户角色和权限信息。4.常见错误包括签名验证失败、令牌过期和Payload过大,调试技巧包括使用调试工具和日志记录。5.性能优化和最佳实践包括使用合适的签名算法、合理设置有效期、

您如何在PHP中解析和处理HTML/XML? 您如何在PHP中解析和处理HTML/XML? Feb 07, 2025 am 11:57 AM

本教程演示了如何使用PHP有效地处理XML文档。 XML(可扩展的标记语言)是一种用于人类可读性和机器解析的多功能文本标记语言。它通常用于数据存储

php程序在字符串中计数元音 php程序在字符串中计数元音 Feb 07, 2025 pm 12:12 PM

字符串是由字符组成的序列,包括字母、数字和符号。本教程将学习如何使用不同的方法在PHP中计算给定字符串中元音的数量。英语中的元音是a、e、i、o、u,它们可以是大写或小写。 什么是元音? 元音是代表特定语音的字母字符。英语中共有五个元音,包括大写和小写: a, e, i, o, u 示例 1 输入:字符串 = "Tutorialspoint" 输出:6 解释 字符串 "Tutorialspoint" 中的元音是 u、o、i、a、o、i。总共有 6 个元

解释PHP中的晚期静态绑定(静态::)。 解释PHP中的晚期静态绑定(静态::)。 Apr 03, 2025 am 12:04 AM

静态绑定(static::)在PHP中实现晚期静态绑定(LSB),允许在静态上下文中引用调用类而非定义类。1)解析过程在运行时进行,2)在继承关系中向上查找调用类,3)可能带来性能开销。

什么是PHP魔术方法(__ -construct,__destruct,__call,__get,__ set等)并提供用例? 什么是PHP魔术方法(__ -construct,__destruct,__call,__get,__ set等)并提供用例? Apr 03, 2025 am 12:03 AM

PHP的魔法方法有哪些?PHP的魔法方法包括:1.\_\_construct,用于初始化对象;2.\_\_destruct,用于清理资源;3.\_\_call,处理不存在的方法调用;4.\_\_get,实现动态属性访问;5.\_\_set,实现动态属性设置。这些方法在特定情况下自动调用,提升代码的灵活性和效率。

See all articles