README

一个管理你的 PHP School 工作坊的工具。轻松搜索、安装、更新和删除工作坊！

安装

Phar

这是推荐的安装方法。

curl -O https://php-school.github.io/workshop-manager/workshop-manager.phar
mv workshop-manager.phar /usr/local/bin/workshop-manager
chmod +x /usr/local/bin/workshop-manager
workshop-manager verify

Composer

如果你通过 Composer 安装 workshop-manager，你需要确保你没有与其它全局安装的工具冲突的依赖项。你还需要能够使用自更新和回滚命令。

你需要确保你的 composer global bin 目录在你的 $PATH 环境变量中可用。

composer global require php-school/workshop-manager
workshop-manager verify

以下代码片段将下载 phar 包（一个可执行的 PHP 包），并将其移动到公共安装目录，使其可执行，然后运行工作坊管理器的验证命令。如果一切顺利，你应该会看到一些绿色的成功信息。

用法 / 命令

搜索 | 查找

通过其名称的一部分快速查找可用的工作坊，并立即得知它们是否已经安装。

 workshop-manager search php
 
 # Result
  *** Matches ***
 
 +----------------+--------------------------------------------------+-------------+-----------+------------+
 | Name           | Description                                      | Code        | Type      | Installed? |
 +----------------+--------------------------------------------------+-------------+-----------+------------+
 | Learn you PHP! | A simple introduction into PHP and the workshop  | learnyouphp | Core      |     ✘      |
 |                | format.                                          |             |           |            |
 | PHP7 way       | A PHP School workshop about some new features in | php7way     + Community |     ✘      |
 |                | PHP7.                                            |             |           |            |
 +----------------+--------------------------------------------------+-------------+-----------+------------+

安装

通过其包字段安装工作坊，你可以通过像上面那样的搜索找到它。

 workshop-manager install learnyouphp

然后，你可以通过使用其包名称立即开始使用工作坊，在这种情况下，你只需在终端中运行 learnyouphp。

提示：如果出现错误并且你不确定是什么，用 -vvv 运行以获取更多详细信息或为我们创建一个问题。

更新

这是一个简单的方式来更新你已安装的工作坊。由于工作坊只是包，它们可能包含错误 😱 因此保持它们更新很重要！

 workshop-manager update learnyouphp

卸载 | 删除

通过其包名称删除工作坊。

 workshop-manager uninstall learnyouphp

已安装

列出已安装的工作坊，这样你就知道可以开始做什么了 😉

它还会告诉你是否需要更新你已安装的工作坊。

 workshop-manager installed
 
 # Result
 *** Installed Workshops ***
 
 +----------------+-------------------------------------------------+-------------+-----------+---------+------------------------+
 | Name           | Description                                     | Code        | Type      | Version | New version available? |
 +----------------+-------------------------------------------------+-------------+-----------+---------+------------------------+
 | Learn you PHP! | A simple introduction into PHP and the workshop | learnyouphp | Community | 0.3.1   | Nope!                  |
 |                | format.                                         |             |           |         |                        |
 +----------------+-------------------------------------------------+-------------+-----------+---------+------------------------+

自更新

保持工作坊管理器更新与更新工作坊本身一样重要。我们并不完美，可能存在错误，或者我们可能推出一些超级酷的功能，无论如何，你应该定期运行这个命令。

 workshop-manager self-update

然后你可以像以前一样继续使用工作坊管理器。

回滚

在 self-update 之后出了什么可怕的问题？不用担心，我们支持你 😉 只需运行...

 workshop-manager rollback

然后你可能想为那个你发现的可怕错误创建一个问题 😂

验证

如果你遇到问题，可能需要验证你的安装。此命令将帮助诊断这些问题，并指出正确的方向。

 workshop-manager verify

贡献

我们欢迎所有贡献，新的工作坊，错别字，功能请求，错误修复等等。

要为代码做出贡献，只需克隆项目，进行更改，并确保所有测试都运行。

添加工作坊

我们非常乐意添加你的工作坊，这样它就可以通过工作坊管理器安装。要这样做，只需填写该表格并让我们看看，我们将很快将其添加！

开发可执行文件

在开发酷炫的新功能时，你将想要使用源可执行文件而不是构建的 phar 文件。要这样做，只需运行以下...

php bin/workshop-manager

测试

嗯嗯嗯，测试，我们都喜欢一个好的测试！要运行套件，使用 PHPUnit 如此...

composer test

由 PHPSchool 团队用 ❤️ 制作

php-school / workshop-manager

维护者

详细信息