README

用于操作 Concrete CMS 的命令行实用工具。

安装

作为 PHAR 文件

控制台 cli 工具的最新版本可在以下地址获得

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

concrete 控制台 cli 工具也可以使用 composer 全局安装

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"

To the $HOME/.profile file (for the current user only), or to /etc/profile (for any user)

运行命令

您可以这样运行命令

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 周围的工具，并逐步淘汰内置到核心中的原始控制台实用工具。

concretecms / console

维护者

详情