README

这是您自己的 papayaCMS 项目的项目骨架。它允许使用 Composer 进行项目初始化。

它包括一个用于 Phing 的构建文件。它使用 composer 和 git 命令，所以请确保它们可以被调用。

composer create-project papaya/cms-project projectname

如果您想使用最新开发版本，请使用

composer create-project papaya/cms-project projectname -s dev

使用 Phive

您可以使用 Phive 安装 papaya 的工具。工具将被安装到子目录 tools/ 中。

cd projectname
phive install
composer install
tools/phing

手动安装

确保您能调用 phing 并运行它。

cd projectname
composer install
phing

本地开发服务器

默认情况下，骨架配置为使用 SQLite 3 数据库，并且可以与 PHP 内置的 web 服务器一起工作。

定义构建属性

将文件 dist.build.properties 复制到 build.properties 并进行修改。目前它包括数据库连接的两个选项。一个用于开发，一个用于部署。

初始化 Git 仓库（可选）

骨架已针对与 Git 一起使用进行了优化。现在初始化仓库是一个好时机。

git init
git add *
git commit -m"new project" 

启动 Web 服务器

您可以使用构建脚本来在端口 8080 上启动 papaya CMS 项目的 Web 服务器。

phing run

这将安装依赖项（composer install），更新版本文件并启动 PHP 内置的 web 服务器。

在浏览器中打开 http://localhost:8080/papaya 以继续设置。

更新项目依赖

根据仓库（composer.lock）定义安装依赖项

phing dependencies-install

更新依赖项（composer.json）

phing dependencies-update

因为 papaya CMS 使用 composer，所以您可以通过调用 composer install 来安装由仓库定义的依赖项或 composer update 来更新它们。但是，这将不会更新版本文件（用于在管理界面中显示项目和 papaya 核心版本）。

克隆现有项目

在克隆现有项目后，您将必须直接调用 composer install。

主要构建文件由 papaya CMS 核心提供。如果您克隆现有项目仓库，则依赖项不可用，因此构建任务也不可用。最初，依赖项是通过 composer create-project 安装的。因此，您将必须一次性安装它们（或者如果您删除了 vendor 目录）。

模块

添加额外的模块包

composer require papaya/module-domains

项目内的模块

特定于项目的模块可以放入 src/ 目录。

主题和模板

主题和模板也可以是 composer 包。

composer require papaya/theme-dynamic

主题包将对模板包有依赖。您无需手动要求它们。（但您可以选择这样做。）

项目内的模板

模板安装到模板子目录。您可以在项目中添加一个新目录，并在此处开发/维护模板。

项目内的主题

主题安装到 htdocs/papaya-themes 子目录。您可以在项目中添加一个新目录，并在此处开发/维护主题。

导出项目以部署

《build.properties》文件（在从《dist.build.properties》复制后）包含一个属性《dist.database.uri》，该属性将在导出配置文件时使用。

此外，导出还将使用Git标签。如果当前提交被打上标签，则该标签将被用于文件/目录名。

phing export