papaya/cms-core

papaya CMS 核心框架

维护者

详细信息

github.com/papayaCMS/papayacms-core

主页

源代码

问题

安装数： 4,699

依赖项: 42

建议者: 0

安全性: 0

星标: 11

关注者: 10

分支: 6

公开问题: 15

6.15.3 2022-02-17 17:54 UTC

Requires

  • php: >=7.2.0
  • ext-dom: *
  • ext-gd: *
  • ext-json: *
  • ext-libxml: *
  • ext-xsl: *
  • psr/log: 1.*

Requires (Dev)

GPL-2.0 f4ba773f5b306c72e028a912ca22b9abcdc2c323

This package is auto-updated.

Last update: 2024-09-20 10:54:40 UTC

README

papaya CMS 内容管理系统和Web应用框架

(有关 papaya CMS 的更多信息，请参阅项目网站)

Build Status License Total Downloads Latest Stable Version Latest Unstable Version

虽然我们试图通过此 README 文件提供有用的概述，但请参阅我们的网站 www.papaya-cms.com 获取更多详细信息。

如果您有任何问题未在文档中解答，请在我们公共论坛 http://www.papaya-cms.com/forum 上留言。

如果您发现了一个错误或有任何改进建议，我们非常乐意听取您的意见 - 请在 https://github.com/papayaCMS/papayacms-core/issues 上提交错误报告，或者甚至分支项目并提交拉取请求。

以下是一些起点，希望让您能够愉快地与 papaya CMS 联系。

英语

遗憾的是，英文文档尚未达到德文文档的覆盖范围。因此，如果您至少会说一点德语，请查看德文链接。

德语

  • 通用
  • 许可证
  • 系统要求
  • 安装
    1. 创建新项目
    2. 基本配置
    3. 目录
    4. 设置权限
  • 初始化和配置
    1. 初始化数据库
    2. 配置
    3. 用户和密码
  • 故障排除
  • 附录
    1. 在子目录中安装 papaya CMS
    2. httpd.conf 中的重写规则
    3. Apache mod_vhost_alias
    4. MySQL >= 4.1 和字符集

通用

感谢您下载 papaya CMS 并进行测试/使用。使用是免费的，条件如下所述的 GNU 通用公共许可证，版本 2 (GPL V2)。

papaya CMS 是一个面向大型网站和复杂 Web 应用的开源 CMS。它不使用任何专有模板或脚本语言，完全基于开放标准（例如 PHP、MySQL/PostgreSQL、XSL/XSLT 等）。

最新信息可在 [http://www.papaya-cms.com] 获取。

许可证

papaya CMS 受 GNU 通用公共许可证，版本 2 (GPL V2) 的约束。有关 GPL 的完整文本，请参阅 gpl.txt。

有关包含在此 papaya CMS 版本中的其他开源软件列表，请参阅 credits.txt。

系统要求

服务器

  • PHP >= 5.6

    • XML (ext/xml)
    • XSLT (ext/xsl)
    • 数据库扩展 (ext/sqlite3, ext/mysql, ext/mysqli 或 ext/pgsql)
    • 会话 (ext/session)
    • PCRE (ext/pcre)
    • GD (ext/gd)

  • Web 服务器

    • PHP嵌入式网络服务器（用于开发）
    • Apache httpd 2.x
      • mod_rewrite

  • 数据库

    • SQLite 3
    • MySQL >= 4.1.x
    • PostgreSQL >= 8.0

客户端（用于管理）

  • 网页浏览器（推荐Firefox）
    • JavaScript

客户端（用于使用默认模板输出）

  • 网页浏览器
    • JavaScript（可选 - 用于弹出窗口和闪存）

安装

安装使用Composer和Phing。

创建新项目

调用Composer获取项目框架。

composer create-project papaya/cms-project projectname

快速设置（用于开发）

在项目目录中调用Phing

cd projectname
phing

启动PHP内置网络服务器

php -S localhost:8080 -t ./htdocs server.php

在浏览器中打开URL http://localhost:8080/papaya（确保JavaScript已启用）并按照安装步骤操作。

您可以将项目目录初始化为git仓库并将其推送到服务器。您可以在下面的“安装和配置”部分了解更多信息。

基本配置

将dist.build.properties复制到build.properties并更改数据库uri选项。build.properties将不会被提交到Git，因此任何开发者都可以有自己的本地构建配置。

这里有两个数据库选项：database.uri用于本地安装，dist.database.uri用于分发/发布。

数据库地址遵循以下方案

  • 协议://用户:密码@主机名/数据库名或
  • 协议://./路径/文件

例如。

  • mysql://web1:secret@localhost/usr_web1_1或
  • sqlite3://./papaya.sqlite

您应该已经从您的ISP或系统管理员那里收到了这些信息。

在项目目录中调用Phing会触发Composer安装依赖项并创建配置文件（papaya.php）。现有papaya.php不会被覆盖。

要覆盖papaya.php，请调用

phing config-regenerate

导出项目以进行分发

Phing构建文件包含用于编译项目构建的分发目标。

创建一个目录

phing export-directory

创建一个tar gz存档

phing export-tgz

创建一个zip存档

phing export-zip

目录

htdocs/

网络服务器的文档根。如果您需要重命名，您需要在composer.json中提供。

{
  "extra" : {
    "document-root" : "htdocs/"
  }
}

htdocs/papaya/

Composer将安装管理界面到这个目录。

htdocs/papaya-themes/

存放papaya主题的目录。主题包含项目的css、js和布局图片。所有需要发送到浏览器的静态资源。

它们可以通过Composer安装或作为项目的一部分。

papaya-data/

此目录包含文件缓存和媒体文件。它需要被网络服务器可写。

src/

存放项目papaya模块的目录，除了通过Composer安装的。

templates/

默认的XSLT模板集目录。它可以使用composer.json进行更改。

{
  "extra" : {
    "papaya" : {
      "template-directory": "templates/"
    }
  }
}

它们可以通过Composer安装或作为项目的一部分。

设置权限

为Windows（XP、2003服务器和更高版本）设置权限

必须为“papaya-data”文件夹授予网络服务器的写入权限。可以通过Windows资源管理器并右键单击文件夹来设置文件权限。但是，Windows安装通常不需要设置权限。

为Unix（Linux、Unix、BSD等）设置权限

必须为“papaya-data”目录授予网络服务器的写入权限。可以通过FTP客户端设置文件权限。将此目录的权限设置为“0777”。

可能还有更严格的权限。请咨询您的服务器管理员。

papaya CMS已安装。请继续阅读本文件的初始化和配置部分。

初始化和配置

1. 开始安装脚本

使用您的网页浏览器打开 http://www.domain.tld/papaya/install（将 www.domain.tld 替换为您自己的域名）。安装脚本的起始页面会显示。起始页面包含到常见问题解答、安装论坛、支持页面和 papaya 网站的链接。

点击“下一步”进入下一个步骤。

2. 同意许可协议

安装脚本的下一步将显示 GPL 的副本。您需要接受许可协议才能继续。为此，请点击“接受许可”。

3. 检查系统

在安装的下一步中，脚本将检查您的系统是否与 papaya CMS 兼容，以及是否所有必需的扩展都已可用。如果是这样，您可以继续安装的下一步。通过点击“下一步”来实现。

4. 定义 PAPAYA_PATH_DATA 并设置管理员账户

4a. 设置 PAPAYA_PATH_DATA 的路径

输入 PAPAYA_PATH_DATA 选项的 papaya-data 目录的路径。请提供绝对路径。

4b. 设置管理员账户

输入姓名、姓氏、电子邮件地址、登录名以及密码。点击“保存”。

5. 设置配置表

在安装脚本的下一步中，您将提示创建配置表。点击“创建”以创建配置表并继续安装。

注意 - 当数据库连接未正确配置时，提示不会显示。

6. 初始化数据库

创建配置表后，您将看到一个数据库表列表以及以下菜单。

  1. 分析数据库

    检查数据库中现有的表。（如果没有必要的表存在，则禁用）

  2. 更新数据库

    创建缺失的表并更新现有表。（如果没有必要进行修改，则禁用）

  3. 插入默认数据

    在所选表中插入默认值。警告：现有数据将被从表中删除！（您可以多次执行此操作）

  4. 检查选项和模块

    检查选项，设置默认值并查找已安装的模块（您可以多次执行此操作）

  5. 转到管理员界面

    打开用户管理员界面。

逐个点击每个选项。安装工具将修改现有表而不会删除数据。当您想要更新系统而不会丢失内容时，可以重复使用此工具。

其他模块（例如论坛）的表可以在稍后通过管理模块安装。

现在 papaya CMS 的数据库已初始化，papaya CMS 准备进行配置。当您点击“5) 转到管理员界面”中的链接时，您将自动登录到 papaya 后端，在那里您可以开始配置 papaya CMS。

7. 配置

7a) 数据库初始化后的登录

如果您已中断 papaya CMS 的安装过程，希望稍后配置 papaya CMS，您需要登录到 papaya CMS 的后端。

  1. 使用您的网页浏览器打开 http://www.domain.tld/papaya/。请将 www.domain.tld 替换为您已安装 papaya CMS 的实际域名。
  2. 使用您的用户名和密码登录。当您配置默认管理员的账户时，已输入用户名和密码，您应该已经拥有账户信息。

如果您在数据库初始化后直接继续安装，您将自动登录。

7b) 继续配置

在“管理”菜单组中点击“设置”按钮。papaya CMS的系统设置部分将被打开。

重要选项

文件和目录 PAPAYA_PATH_DATA - 数据目录路径（papaya-data/） PAPAYA_PATH_WEB - webroot 下的路径 （/）

布局 PAPAYA_LAYOUT_TEMPLATES - XSLT 目录 PAPAYA_LAYOUT_THEME - 包含 CSS 和布局图像的目录

重要 - 有时候，在安装过程中无法设置 PAPAYA_PATH_DATA 选项。如果此选项显示了一个值，但选项被设置为括号内，则表明设置失败。您必须编辑并保存该选项。保存选项后，括号将消失。

设置 PAPAYA_PATH_DATA 选项后，点击“检查路径”。系统会检查数据路径权限，并在不存在的情况下为媒体数据库创建必要的子目录。

8. 用户和密码

在“管理”菜单组中点击“用户”。在用户管理中，您可以创建每个新用户的账户。

注意 - 为每个作者创建一个用户账户。然后，每个页面的作者将作为页面信息的一部分显示。

故障排除

如果您在安装或使用 papaya CMS 时遇到任何问题，请咨询以下资源。这将帮助我们通过花费更少的时间重复回答已在其他地方回答过的问题，并专注于系统开发。这也帮助我们保留我们剩余的一点点头发。

  1. 阅读常见问题解答： http://www.papaya-cms.com/faq/
  2. 阅读文档： http://www.papaya-cms.com/docs/
  3. 搜索论坛： http://www.papaya-cms.com/forum/
  4. 步骤 1 - 3 没有帮助？
    -> 在我们的论坛中发消息（《http://www.papaya-cms.com/forum/》）请尽可能提供有关您问题的详细信息（例如，操作系统、版本号等）。这不仅可以帮助我们找到问题，也可以帮助那些在您之后遇到类似问题的用户。

附录

1. 在子目录中安装 papaya CMS

您可以将 papaya CMS 安装在您的 web 服务器的一个子目录中。您必须修改 .htaccess 文件以指向子目录。.htaccess 文件必须保留在您的文档根目录中。您可以在 papaya 核心目录的 readme 中找到一个示例 .htaccess 文件（htaccess.tpl）。用占位符 {%webpath_pages%} 替换目录名。

示例

  pages/
  cms/page/

请注意，您不能输入路径前面的斜杠（在路径之前），但必须添加路径后面的斜杠（在路径之后）。

2. httpd.conf 中的重写规则

您可以将 .htaccess 的内容直接放入您的 web 服务器配置文件中。如果可能，请使用按目录配置。

然后不再需要 .htaccess，可以禁用它或完全删除。

3. Apache mod_vhost_alias

如果您使用 mod_vhost_alias，PHP 超全局 $_SERVER['DOCUMENT_ROOT'] 将返回一个错误值。安装程序将无法计算正确的路径。在这种情况下，您必须手动在您的 conf.inc.php 中纠正路径，并添加以下行

$_SERVER['DOCUMENT_ROOT'] = '/path/vhosts/hostname/';

请将 '/path/vhosts/hostname/' 替换为您的 web 服务器上 papaya 安装的虚拟文档根的实际路径。

同样需要纠正 .htaccess 文件中的重写规则路径。如果您将 papaya CMS 直接安装在文档根目录中，您可以使用安装包文件目录中的 .htaccess。

4. MySQL >= 4.1 和字符集

从版本4.1开始，MySQL支持Unicode字符集。如果您使用MySQL 4.1或更高版本，请确保表使用UTF-8作为默认字符集。您可以通过查看表的校对方式来验证这一点。它必须以"utf8"开头（例如utf8_general_ci）。