README

Starter是基于Energine的默认项目

前言

从energine 2.11.0版本开始，项目结构发生了变化。现在，energine的核心可以存储在单独的目录中（例如 /var/www/energine）。

因此，项目不再通过svn:externals拉取核心和模块，而是通过配置中指定的位置连接所需的核心版本和第三方模块。

因此，为了在自己的环境中部署基于energine的项目，您需要

1. 创建一个用于存储核心的目录（例如 /var/www/energine）

示例：mkdir /var/www/energine

1. 解压缩带有核心的发行版或从svn提取一个稳定的内核（从版本tags/2.11.8或trunk开始）

示例提取稳定版本和trunk版本：cd /var/www/energine svn checkout https://energine.googlecode.com/svn/tags/2.11.8 2.11.8 svn checkout https://energine.googlecode.com/svn/trunk trunk

1. 从svn提取项目starter从一个稳定的版本，或者从trunk提取 bleeding-edge版本

示例：cd /home/username/projects svn checkout https://energine.googlecode.com/svn/tags/2.11.8/starter www.mynewsite.com

1. 接下来需要创建一个mysql数据库

4.1 从sql/starter.structure.sql导入基本结构 4.2 从sql/starter.routines.sql导入存储过程 4.3 从sql/starter.data.sql导入系统数据

1. 将配置文件从configs/system.config.default.php复制到configs/system.config.username.php，然后从configs/system.config.username.php创建到htdocs/system.config.php的符号链接

2. 编辑配置文件，至少需要输入以下数据

• 指定当前核心的目录，该目录将用于获取setup和core/modules
• 设置数据库的正确配置
• 指定网站域名
• 指定将在网站上可用的模块列表，包括每个模块的完整路径
• 替换电子邮件地址为您的地址

1. 配置Web服务器（nginx+php_fpm或apache2+mod_php）

7.1. 配置nginx：nginx的基本配置位于jambalaya/.nginx.conf.example。可以将此配置复制到nginx配置目录的conf.d文件夹中，例如www.mysite.com.conf

7.1.1 在upstream php-fpm块中，需要指定连接php-fpm的方式。示例中指定了通过socket连接 7.1.2 在server块中，需要使用listen指令设置正确的server_name和端口 7.1.3 在server块中，需要设置到项目的绝对路径，使用变量$www_folder

之后，nginx已配置完毕 - 可以重启php-fpm和nginx，并享受刚刚创建的项目

7.2. 配置apache2：apache的基本配置位于jambalaya/.htaccess。假设VirtualHost已经配置，因此接下来的所有设置都仅涉及mod_rewrite模块

7.2.1. 请将此配置文件复制到目录 www.mysite.com/htdocs/ 7.2.2. 修改唯一的RewriteBase指令。如果项目位于网站根目录之外的文件夹中，指令的示例为RewriteBase /~username/some/folder/。如果网站位于根目录，则无需修改RewriteBase /

1. 为目录htdocs/uploads设置写入权限（以及在使用Apache的情况下，为htdocs和htdocs/core/modules设置写入权限）并启动http://<项目地址>/setup/ 如果一切顺利，您将拥有基于Energine引擎的最小运行版系统。

2. 使用Energine开发网站 ;)

3. 移除目录htdocs和htdocs/core/modules的写入权限（在使用Apache的情况下）

4. 在将配置文件发布到生产环境之前，关闭配置文件中的debug模式

======================================================================================================= (c) 2013 Energine Team