发表 admin at 2025年2月28日

类别

未分类

标签

如何在 CentOS 7 上安装 Grav CMS

在此页

要求
先决条件
初始步骤
第 1 步 - 安装 PHP 和必要的 PHP 扩展
第 2 步 - 安装 acme.sh 客户端并获取 Lets Encrypt 证书（可选）
第 3 步 - 安装和配置 NGINX
第 4 步 - 安装 Grav CMS
第 5 步 - 完成 Grav 设置
链接

Grav 是一个快速、简单且灵活的基于文件的 CMS 平台。 Grav 带有一个强大的包管理系统，允许简单地安装和升级插件和主题，以及简单地更新 Grav 本身。

Grav 的底层架构旨在使用成熟且一流的技术来确保 Grav 易于使用且易于扩展。其中一些关键技术包括：

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

要求

Grav 的设计要求很少。 Grav 是用纯文本文件为您的内容构建的。不需要数据库。

确保您的系统满足以下要求：

Web 服务器（Apache、Nginx、LiteSpeed、Lightly、IIS 等）我们将使用 NGINX。
PHP 7.1.3 或更高版本

先决条件

运行 CentOS 7 的操作系统。
具有 sudo 权限的非根用户。

初始步骤

检查您的 CentOS 版本：

cat /etc/centos-release
# CentOS Linux release 7.6.1810 (Core)

设置时区：

timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'

更新您的操作系统包（软件）。这是重要的第一步，因为它确保您拥有操作系统默认软件包的最新更新和安全修复程序：

sudo yum update -y

安装 CentOS 操作系统基本管理所需的一些基本软件包：

sudo yum install -y curl wget vim git unzip socat bash-completion epel-release

第 1 步 - 安装 PHP 和必要的 PHP 扩展

设置 Webtatic YUM 仓库：

sudo rpm -Uvh https://mirror.webtatic.com/yum/el7/webtatic-release.rpm

安装 PHP 以及必要的 PHP 扩展：

sudo yum install -y php72w php72w-cli php72w-fpm php72w-common php72w-curl php72w-gd php72w-json php72w-mbstring php72w-xml php72w-zip php72w-opcache php72w-pecl-apcu

要显示在模块中编译的 PHP，您可以运行：

php -m

ctype
curl
exif
fileinfo
. . .
. . .

检查 PHP 版本：

php --version

# PHP 7.2.17 (cli) (built: May 13 2019 18:03:04) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
#     with Zend OPcache v7.2.17, Copyright (c) 1999-2018, by Zend Technologies

启动并启用 PHP-FPM 服务：

sudo systemctl start php-fpm.service
sudo systemctl enable php-fpm.service

第 2 步 - 安装 acme.sh 客户端并获取 Lets Encrypt 证书（可选）

不必使用 HTTPS 保护您的论坛，但这是保护您的网站流量的好习惯。为了从 Lets Encrypt 获得 TLS 证书，我们将使用 acme.sh 客户端。 Acme.sh 是一款纯 UNIX shell 软件，用于从 Lets Encrypt 以零依赖方式获取 TLS 证书。

下载并安装 acme.sh：

sudo su - root
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh 
./acme.sh --install --accountemail 
source ~/.bashrc
cd ~

检查 acme.sh 版本：

acme.sh --version
# v2.8.0

为您的域/主机名获取 RSA 和 ECC/ECDSA 证书：<br>

# RSA 2048
acme.sh --issue --standalone -d example.com --keylength 2048
# ECDSA
acme.sh --issue --standalone -d example.com --keylength ec-256

如果你想要假证书进行测试，你可以在上面的命令中添加 --staging 标志。

运行上述命令后，您的证书和密钥将位于：

对于 RSA：/home/username/example.com 目录。
对于 ECC/ECDSA：/home/username/example.com_ecc 目录。

要列出您颁发的证书，您可以运行：

acme.sh --list

创建一个目录来存储您的证书。我们将使用 /etc/letsencrypt 目录。

mkdir -p /etc/letsecnrypt/example.com
sudo mkdir -p /etc/letsencrypt/example.com_ecc

安装/复制证书到 /etc/letsencrypt 目录。

# RSA
acme.sh --install-cert -d example.com --cert-file /etc/letsencrypt/example.com/cert.pem --key-file /etc/letsencrypt/example.com/private.key --fullchain-file /etc/letsencrypt/example.com/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"
# ECC/ECDSA
acme.sh --install-cert -d example.com --ecc --cert-file /etc/letsencrypt/example.com_ecc/cert.pem --key-file /etc/letsencrypt/example.com_ecc/private.key --fullchain-file /etc/letsencrypt/example.com_ecc/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"

所有证书将每 60 天自动更新一次。

获得证书后，从 root 用户退出并返回到普通 sudo 用户：

exit

第 3 步 - 安装和配置 NGINX

安装 Nginx：

sudo yum install -y nginx

检查 NGINX 版本：

nginx -v
# nginx version: nginx/1.12.2

启动并启用 NGINX 服务：

sudo systemctl start nginx.service
sudo systemctl enable nginx.service

为 Grav 配置 NGINX。运行 sudo vim /etc/nginx/conf.d/grav.conf 并添加以下配置。

server {
  
  listen 80;
  listen 443 ssl;

  server_name example.com;
  root /var/www/grav;

  ssl_certificate /etc/letsencrypt/example.com/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/example.com/private.key;
  ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.key;

  index index.html index.php;
  
  location / {
    try_files $uri $uri/ /index.php?$query_string;
  }
  
  location ~* /(\.git|cache|bin|logs|backup|tests)/.*$ { return 403; }
  location ~* /(system|vendor)/.*\.(txt|xml|md|html|yaml|yml|php|pl|py|cgi|twig|sh|bat)$ { return 403; }
  location ~* /user/.*\.(txt|md|yaml|yml|php|pl|py|cgi|twig|sh|bat)$ { return 403; }
  location ~ /(LICENSE\.txt|composer\.lock|composer\.json|nginx\.conf|web\.config|htaccess\.txt|\.htaccess) { return 403; }

  location ~ \.php$ {
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_split_path_info ^(.+\.php)(/.+)$;
    fastcgi_index index.php;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root/$fastcgi_script_name;
  }

}

检查 NGINX 配置是否存在语法错误：

sudo nginx -t

重新加载 NGINX 服务：

sudo systemctl reload nginx.service

第 4 步 - 安装 Grav CMS

创建文档根目录：

sudo mkdir -p /var/www/grav

将 /var/www/grav 目录的所有权更改为 johndoe:

sudo chown -R johndoe:johndoe /var/www/grav

导航到文档根文件夹：

cd /var/www/grav

下载并解压 Grav：

wget https://getgrav.org/download/core/grav-admin/1.6.9
unzip 1.6.9
mv grav-admin/* . && mv grav-admin/.* .
rm -rf grav-admin 1.6.9

注意：版本 1.6.9 是当前版本，在您阅读本文时可能有所不同。请查看 Grav 网站以获取最新信息。

将 /var/www/grav 目录的所有权更改为 nginx:

sudo chown -R nginx:nginx /var/www/grav

运行 sudo vim /etc/php-fpm.d/www.conf 并将用户和组设置为 nginx。最初，它将设置为用户和组 apache:

sudo vim /etc/php-fpm.d/www.conf
# user = nginx
# group = nginx

重新启动 PHP-FPM 服务。

sudo systemctl restart php-fpm.service

创建 /var/lib/php/session/ 目录并将所有权更改为 nginx:

sudo mkdir -p /var/lib/php/session/ && sudo chown -R nginx:nginx /var/lib/php/session/

在网络浏览器中打开 http://example.com，然后按照屏幕上的说明进行操作。要访问 Grav 管理员，请将 /admin 附加到您的 URL。

第 5 步 - 完成重力设置

创建一个 Grav 管理员用户：

创建后，您将被重定向到管理仪表板：

链接

https://getgrav.org/
https://github.com/getgrav/grav