README

分步使用Ouzo。设置示例项目并开始体验Ouzo只需5分钟。

设置项目

只需使用composer (https://getcomposer.org.cn)

composer.phar create-project letsdrink/ouzo-app:1.4.0 myproject

其中 myproject 是您项目的名称。

下载Ouzo及其依赖项后，您将需要选择要使用的数据库。Ouzo将为您准备配置文件。如果需要，数据库配置可以手动更改。

PHP版本

您需要

• 安装PHP 5.6或更高版本。目前Ouzo已在5.6、7.0和7.1环境中进行了测试。
• 数据库驱动，根据您所使用的数据库。

要获取可用驱动的列表，请检查https://php.ac.cn/manual/en/pdo.getavailabledrivers.php。

配置HTTP服务器

Ouzo应用程序可以在Apache Web服务器上运行。它需要启用mod_rewrite。完成前一步后，将文档根目录更改为myproject。

Ouzo配置

Ouzo配置位于config/prod/config.php。

目前重要的是默认启用了调试。请保持原样，以便在安装过程中，您将能够在出现问题时看到详细的错误消息。

数据库配置

将为您选择的数据库自动生成配置。您需要先创建数据库和数据库用户。

对于MySQL

CREATE DATABASE myproject;
CREATE USER 'ouzo'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON myproject.* TO 'ouzo'@'localhost';

对于PostgreSQL

CREATE DATABASE myproject;
CREATE USER ouzo WITH PASSWORD 'password';
GRANT ALL PRIVILEGES ON DATABASE myproject to ouzo;

如果您不使用composer，示例项目默认使用PostgreSQL。数据库配置可以在Ouzo配置文件中找到

$config['db']['dbname'] = 'myproject';
$config['db']['user'] = 'ouzo';
$config['db']['pass'] = 'password';
$config['db']['driver'] = 'pgsql';
$config['db']['host'] = '127.0.0.1';
$config['db']['port'] = '5432';
$config['sql_dialect'] = '\\Ouzo\\Db\\Dialect\\PostgresDialect';

您需要提供数据库名称、用户名 & 密码、驱动程序、主机、端口和SQL方言类。目前Ouzo支持

• PostgreSQL - \Ouzo\Db\Dialect\PostgresDialect
• MySQL - \Ouzo\Db\Dialect\MySqlDialect
• SQLite3 - \Ouzo\Db\Dialect\Sqlite3Dialect

迁移

开始时，您的数据库为空。为了展示Ouzo的功能，我们已创建了一个示例数据库。使用db.sh脚本来应用迁移

./db.sh db:migrate

要查看相关迁移动作的完整列表，请运行

./db.sh

Ouzo使用Ruckusing框架进行迁移 (https://github.com/ruckus/ruckusing-migrations)。

查看应用程序！

打开您喜欢的浏览器并转到https:///myproject。您的第一个Ouzo项目现在正在运行！您可以通过添加、浏览和编辑用户来玩。

运行测试

测试配置位于config/test/config.php。您将需要一个仅用于测试目的的单独数据库。

为MySQL设置

CREATE DATABASE myproject_test;
GRANT ALL PRIVILEGES ON myproject_test.* TO 'ouzo'@'localhost';

为PostgreSQL设置

CREATE DATABASE myproject_test;
GRANT ALL PRIVILEGES ON DATABASE myproject_test to ouzo;

应用迁移

environment=test ./db.sh db:migrate

现在运行测试

phpunit --bootstrap bootstrap_test.php test/

如果所有测试都通过，那么您就可以继续了！

更多

骨架应用程序说明：http://ouzo.readthedocs.org/en/latest/tutorials/project_structure_explained.html

Ouzo文档：http://ouzo.readthedocs.org