README

kirche.com 由开源内容应用平台 Neos 驱动。此存储库包含专门为 kirche.com 开发的 Neos 发行版。您可以使用自己的内容设置类似 kirche.com 的平台。

请注意，此发行版已包含 kirche.com 网站包，因此如果您使用此发行版，则无需手动安装网站包。

安装

1. 要求

请确保您的 web 服务器满足以下要求

• PHP >= 7.2
• MySQL > 5.7.7 或 MariaDB > 10.2.2
• Composer
• 以下支持的 PHP 图形库之一：ImageMagick、GraphicsMagick、VIPS 或 GD2
• PHP 模块 mbstring、tokenizer 和 pdo_mysql
• Apache 或 Nginx

根据您的系统，以下类似命令可能安装要求

sudo apt install mariadb-server mariadb-client
sudo apt install php-xml php-mbstring php-tokenizer php-mysql php-imagick
curl -sS https://getcomposer.org/installer | php

2. 创建数据库

在您选择的图形数据库管理系统中创建一个新的空数据库，或使用类似以下命令（用您选择的值替换 YOURDATABASENAME 和 YOURPASSWORD）

sudo mysql -u root

create database YOURDATABASENAME;
grant all privileges on YOURDATABASENAME.* TO 'flow'@'localhost' identified by 'YOURPASSWORD';
flush privileges;

3. 安装 Neos 发行版

我们建议使用 composer 克隆此存储库并安装所有依赖项。用您要安装 Neos 的 web 服务器目录替换 DIRECTORY

composer create-project --no-dev --keep-vcs kirchecom/neos-genesis DIRECTORY

如果您处于本地开发环境（即在开发机上），您现在可以进入刚刚创建的目录并执行 ./flow server:run 来启动本地开发服务器。打开显示的 URL 以设置和配置您的 Neos 实例。

如果您处于生产环境，请编辑文件 Web/.htaccess 并取消注释以下行以设置生产环境

SetEnv FLOW_CONTEXT Production

现在打开您的网络浏览器并访问应用程序的 URL 以配置您的 Neos 安装。由于它已包含 kirche.com 网站包，因此无需安装任何网站包。

安装故障排除

在某些系统上，您可能需要调整 Neos 的 Configuration/Settings.yaml 以正确运行。以下是一个示例配置，可能有助于解决一些问题。始终根据您的具体系统调整该文件！

Neos:
  Flow:
    persistence:
      backendOptions:
        driver: pdo_mysql
        host: <REPLACE_WITH_YOUR_HOST>
        dbname: <REPLACE_WITH_YOUR_DB_NAME>
        user: <REPLACE_WITH_YOUR_DB_USER_NAME>
        password: <REPLACE_WITH_YOUR_DB_PASSWORD>
    core:
      phpBinaryPathAndFilename: /usr/local/bin/php
    resource:
      targets:
        localWebDirectoryPersistentResourcesTarget:
          target: Neos\Flow\ResourceManagement\Target\FileSystemSymlinkTarget
          targetOptions:
            relativeSymlinks: true
        localWebDirectoryStaticResourcesTarget:
          target: Neos\Flow\ResourceManagement\Target\FileSystemSymlinkTarget
          targetOptions:
            relativeSymlinks: true
  Imagine:
    driver: Gd

特别是，设置 phpBinaryPathAndFilename 帮助 Neos 找到您的 PHP 解释器。将其设置为您的系统上的实际路径。

设置 relativeSymlinks: true 帮助您为您的资产创建相对符号链接。执行 ./flow resource:publish 以更新资产路径。

如果您遇到有关数据库字符集的问题，./flow database:setcharset 有助于解决。此外，./flow flow:cache:flush --force、./flow flow:session:destroyAll 和 rm -rf Data/Temporary/* 可以解决缓存问题。

更新

要更新 Neos、kirche.com 网站包 和其他依赖项到最新的小版本，包括安全漏洞修复，只需切换到您安装 Neos 的目录并执行

composer update --no-dev

要更新发行版到最新版本，这可能包括破坏性更改，只需获取存储库的最新版本

git checkout master
git pull
composer install --no-dev
composer update --no-dev

更新后，可能需要应用数据库迁移

./flow doctrine:migrationstatus
./flow doctrine:migrate
./flow node:migrationstatus
./flow node:migrate
./flow flow:cache:flush --force
./flow flow:session:destroyAll
./flow resource:publish
rm -rf Data/Temporary/*

许可证

Neos遵循GNU通用公共许可证v3.0。kirche.com站点包遵循欧盟公共许可证1.2。