README

Snap Say 是一个用于在 PHP 中轻松创建类似于 cowsay 的 CLI 程序的包。

使用 Snap\Say 包，您也可以轻松地使用 PHP 创建类似 cowsay 风格的 CLI 程序！

安装

此库需要 PHP 5.4 或更高版本；我们原则上推荐使用最新版本的 PHP。您可以通过 Composer 以 snap/say 的方式安装和自动加载此库。

composer require snap/say

使用

例如，从 https://bitbucket.com/alexfraundorf_com/snap-bobsay 下载 BobSay 包作为示例和/或模板。

1. 创建一个 composer.json 文件，要求包含 snap\say 包。请参阅 BobSay 包中的 composer.json。

2. 创建一个类（例如：Bob），扩展 \Snap\SayAbstract 并覆盖 $title、$description 和 $version 属性。可选地覆盖受保护的 say 方法以自定义输出格式，并添加一些 ASCII 艺术字以使其更加炫酷！请参阅 Bob.php。

3. 创建一个包含每行一个引文的文本文件。请参阅 quotes.txt。

4. 创建您的命令脚本，即您将从命令行调用的脚本，例如：bobsay.php。创建您类的实例，可选地提供引文文件的路径，并调用 run 方法，确保传递 $argv 变量。$argv 是一个数组，包含传递给 bobsay 命令的任何参数。请参阅 bobsay.php。

5. 对于 Linux/Mac 用户的一个加分项：使 bobsay.php 可执行，并将其移动到一级以上，重命名为 bobsay，并将整个项目放在您的 include 路径（如 ~/bin）中的目录中，这样您就可以从任何位置调用程序。

   cd vendor/snap/bobsay/src
   chmod +x bobsay.php
   mv bobsay.php ../../../../bobsay
   

使用您创建的 Say 程序

在 Linux/Mac 上，假设您已按照上述说明操作，并且 say 文件位于您的 include 路径中的一个目录中，您可以从任何位置调用程序。

# random quote
bobsay
# tell Bob what to say
bobsay "My name is Bob and I think you are awesome!"
# pipe output from another program into Archer's mouth (you must install fortune for this example)
fortune | bobsay

在 Windows 上，您需要位于 bobsay.php 文件的同一目录中或提供对其的绝对路径。

# random quote
php bobsay.php
# tell Bob what to say
php bobsay.php "My name is Bob and I think you are awesome!"

使用 Snap/Say 构建的包

示例 BobSay 在 https://bitbucket.com/alexfraundorf_com/snap-bob-say 或 Packagist 上的 Snap/BobSay。

ArcherSay 在 https://bitbucket.com/alexfraundorf_com/snap-archer-say 或 Packagist 上的 Snap/ArcherSay。

告诉我您使用 Snap/Say 编写的包，以便将其包含在此处！

故障排除

1. 权限被拒绝 - 确保您已使 bobsay/bobsay.php 文件可执行。
2. bobsay: 命令未找到 - bobsay 文件不在您的 include 路径中。将它的父目录添加到您的 include 路径，在其父目录内调用它或使用绝对路径到它。
3. PHP 未找到 - 通过运行 php -v 确保已正确安装 PHP。如果没有，请使用您的包管理器安装它。

其他问题或问题：请随时通过 AlexFraundorf.com 联系我，我将尽力帮助您 :-)

快乐地使用 PHP！