Zurmo 开源项目启动与配置教程

1. 项目的目录结构及介绍

Zurmo 是一个以 PHP 为基础的开源 CRM 系统。其目录结构如下：

• app/：包含应用程序的主要代码，包括控制器、模型、视图和模块。
• bin/：存放一些可执行的脚本。
• build/：构建和部署相关的文件和脚本。
• consoles/：控制台应用程序的入口文件和命令。
• data/：存放应用程序的数据文件，如缓存、日志和上传的文件。
• demo/：示例数据和相关文件，用于快速部署演示环境。
• extensions/：存放第三方扩展和自定义模块。
• plugins/：插件目录，包括核心插件和第三方插件。
• protected/：受保护的目录，包含核心代码和框架。
• scripts/：各种脚本文件，用于自动化任务。
• test/：测试相关的代码和文件。
• themes/：应用程序的主题和样式文件。
• uploads/：用户上传的文件，如附件、图片等。
• version/：版本信息文件。
• www/：Web 根目录，包含入口文件和前端资源。

2. 项目的启动文件介绍

项目的启动文件主要是 www/index.php。这是用户访问应用程序时最先加载的文件。以下是启动文件的主要内容：

<?php
// 定义应用程序的根目录
defined(' APPLICATION_PATH ')
    || define('APPLICATION_PATH', dirname(__FILE__));

// 加载应用程序环境设置
require_onceAPPLICATION_PATH . '/../protected/yii.php';

// 创建一个应用程序实例，并运行它
$yii = Yii::createWebApplication( APPLICATION_PATH . '/config/main.php' );
$yii->run();

这段代码定义了应用程序的根目录，加载了 Yii 框架的入口文件，创建了一个应用程序实例，并使用配置文件 protected/config/main.php 来初始化和运行应用程序。

3. 项目的配置文件介绍

配置文件位于 protected/config/ 目录下。主要的配置文件是 main.php。

以下是 main.php 配置文件的一个简化示例：

<?php
// 系统配置
return array(
    'basePath' =>dirname(__FILE__) . DIRECTORY_SEPARATOR . '..',
    'name' => 'Zurmo',

    // 预加载组件
    'preload' => array('log', 'authenticator', 'zurmo', 'translator', ' Rights'},

    // 应用程序组件
    'components' => array(
        // 数据库连接配置
        'db' => array(
            'connectionString' => 'mysql:host=localhost;dbname=zurmo',
            'username' => 'root',
            'password' => 'password',
            'charset' => 'utf8',
        ),
        // 其他组件配置...
    ),

    // 应用程序模块
    'modules' => array(
        // 核心模块
        'ZurmoModule' => array(),
        // 其他模块配置...
    ),

    // 应用程序行为
    'behaviors' => array(
        // 行为配置...
    ),
);

配置文件包含了应用程序的基本设置，如基础路径、应用名称、预加载组件、数据库连接信息、模块和应用程序行为等。这些配置项是启动和运行应用程序的基础。确保在配置文件中正确设置数据库连接信息，以便应用程序可以连接到数据库。