README

Grav 是一个快速、简单、灵活的基于文件的 Web 平台。无需安装。只需解压 ZIP 文件，即可开始使用。它遵循其他基于文件的 CMS 平台的原则，但与大多数平台的设计理念不同。Grav 内置强大的 包管理系统，允许轻松安装和升级插件和主题，以及简单更新 Grav 本身。

Grav 的底层架构旨在使用经过验证和最佳的技术，以确保 Grav 易于使用且易于扩展。其中一些关键技术包括

Twig 模板：用于强大的用户界面控制
Markdown：用于轻松创建内容
YAML：用于简单的配置
Parsedown：用于快速 Markdown 和 Markdown Extra 支持
Doctrine 缓存：用于性能
Pimple 依赖注入容器：用于可扩展性和可维护性
Symfony 事件调度器：用于插件事件处理
Symfony 控制台：用于 CLI 界面
Gregwar 图像库：用于动态图像处理

要求

PHP 7.3.6 或更高版本。请检查所需模块列表
请检查 Apache 或 IIS 要求

文档

完整文档可在 learn.getgrav.org 上找到。

快速入门

以下是获取 Grav 的选项

下载 Grav 包

您可以从 https://getgrav.org 上的下载页面下载一个 预构建 的包

使用 Composer

您可以使用以下命令创建一个新的项目，该项目使用最新的稳定版本 Grav

$ composer create-project getgrav/grav ~/webroot/grav

从 GitHub

将 Grav 存储库从 https://github.com/getgrav/grav 克隆到服务器根目录下的一个文件夹中，例如 ~/webroot/grav。启动一个终端或 控制台 并导航到根目录文件夹
```
$ cd ~/webroot
$ git clone https://github.com/getgrav/grav.git
```
使用 Grav CLI 应用程序 bin/grav 安装插件和 主题依赖。
```
$ cd ~/webroot/grav
$ bin/grav install
```

查看更多信息请参阅安装步骤。

添加功能

您可以从插件或主题的相应标签页在 https://getgrav.org 上的下载页面手动下载，但首选解决方案是使用 Grav 包管理器或 GPM。

$ bin/gpm index

这将显示所有可用的插件，然后您可以使用以下命令安装一个或多个

$ bin/gpm install <plugin/theme>

更新

要更新 Grav，您应使用 Grav 包管理器或 GPM。

$ bin/gpm selfupgrade

更新插件和主题

$ bin/gpm update

从旧版本升级

贡献

我们感谢对 Grav 的任何贡献，无论是关于错误、语法，还是仅仅是一个建议或改进！请参阅贡献指南以获取更多关于此主题的指导。

安全问题

如果您发现与 Grav 或其插件相关的可能的安全问题，请通过电子邮件将问题发送至 [email protected]，我们将尽快处理。

入门指南

什么是 Grav？
在几秒钟内安装 Grav
了解配置
查看我们提供的免费骨架
如果您有任何问题，欢迎加入我们的 Discord 聊天服务器！
祝您玩得开心！

探索更多

查看我们的基础教程
深入了解更多高级功能
了解 Grav CLI
查看 Grav 烹饪书中的示例
更多精彩的 Grav 内容

赞助者

通过每月捐赠支持 Grav，帮助我们继续开发。[成为赞助者]

支持者

通过每月捐赠支持 Grav，帮助我们继续开发。[成为支持者]

赞助商

通过年度捐赠支持 Grav，帮助我们继续开发。[成为赞助商]

许可

查看 LICENSE

运行测试

首先，通过在 Grav 根目录下运行 composer install 安装开发依赖。

然后，运行 composer test 将运行单元测试，这些测试应在任何网站上始终成功执行。Windows 用户应使用 composer test-windows 命令。您还可以运行单个单元测试文件，例如 composer test tests/unit/Grav/Common/AssetsTest.php

要运行 phpstan 测试，您应该运行

composer phpstan 用于全局测试
composer phpstan-framework 用于更严格的测试
composer phpstan-plugins 用于测试所有已安装的插件

getgrav / grav

维护者

详细信息