README

用于与Concrete CMS交互的命令行工具。

安装

作为PHAR文件

控制台命令行工具的最新版本可在以下地址找到

https://github.com/concrete5/console/releases/latest/download/concrete.phar

在Posix系统上安装

只需下载并使其可执行即可

curl -L -o /usr/local/bin/concrete https://github.com/concretecms/console/releases/latest/download/concrete.phar
chmod +x /usr/local/bin/concrete

在Windows系统上安装

您可以将concrete.phar文件下载到您的PATH环境变量中列出的目录（例如：C:\Windows\System32），并在同一目录中创建一个包含以下内容的concrete.bat文件

@php "%~dpn0.phar" %*

使用composer

您还可以使用composer全局安装concrete控制台命令行工具

composer global require concretecms/console

如果您还没有这样做，请确保将全局composer bin目录添加到您的PATH中。

export PATH="$(composer global config bin-dir --absolute --quiet):$PATH"

注意：此命令仅更新当前会话的PATH环境变量。为了使其持久化，您可以将以下行添加到$HOME/.profile文件（仅对当前用户），或添加到/etc/profile（对任何用户）

export PATH="$(composer global config bin-dir --absolute --quiet):$PATH"

运行命令

您可以通过这种方式运行命令

concrete info

这将返回类似以下内容

# Location
Path to instance: /path/to/my/project/public
# concrete5 Version
Installed - Yes
Core Version - 8.5.4
Version Installed - 8.5.4
Database Version - 20200609145307

如果您想针对不同的站点运行命令，或者如果您已全局安装了控制台实用程序，则任何针对特定Concrete实例运行的命令也都有一个--instance选项（或简写为-I）。

concrete info --instance=/path/to/my/site

返回

# Location
Path to instance: /path/to/other/site/web
# concrete5 Version
Installed - Yes
Core Version - 8.5.0
Version Installed - 8.5.0
Database Version - 20190301133300

路线图

我们目前想集中关注的最重要的事项是

• 添加将站点、配置、文件等导入标准化备份存档的能力。
• 添加从这些标准化备份存档中恢复Concrete站点的功能，通过传递文件到特定的concrete restore my_backup.gz命令。
• 提高备份和恢复的稳定性
• 恢复到未安装的concrete5
• 备份版本6的站点

在此之后，我们将很高兴添加您希望的所有功能。这个工具是否应该包括创建样板代码块或包代码的能力？绝对可以！我们应该将代码检查器和代码修复功能从核心控制台命令移动到这个工具中吗？当然，请。

常见问题解答

为什么这个工具没有集成到核心中？

我们希望有一个统一、标准化的地方来提供devops和开发者工具包。核心似乎不是它的理想位置。我们希望能够快速迭代，这意味着不要将此控制台工具的发布与核心的发布绑定。

这个工具的目的是否要替换与核心一起提供的concrete5实用工具？

我还不知道。也许从长远来看，是的——但这似乎需要做很多工作。让我们专注于让这个工具增强和改进围绕 Concrete CMS 的工具，并逐步淘汰内置在核心中的原始控制台实用工具。