README

这是一个 Rindow PHP 应用框架的 Web 应用骨架。您可以使用此骨架创建新的应用程序。

Rindow 框架是一个 PHP 应用框架，为所有 PHP 程序员提供现代的编程和配置模型。请参阅 Rindow 框架。

应用骨架类型

您可以选择骨架类型。

• 标准应用骨架。（此骨架）
  • 典型的 Web 应用程序和命令行应用程序使用模板引擎和数据库。
• 最小 Web 应用骨架。（从这里获取迷你应用程序）
  • 最小应用程序骨架仅包含显示网页的内容。

标准应用骨架的特点

您可以选择您想要使用的平台以及您最常使用的功能。

• 控制反转

  • 控制反转编程实际上由应用程序演示。
  • 通过依赖注入和配置注入可以实现灵活的模块交换。

• 基于注解的配置

  • 组件、控制器、事务、验证、表单等的定义设置为基于注解。

• 模板引擎管理器

  • 包括Twig、Smarty和PHP的独立示例，您可以通过设置进行切换。
  • 我们已经准备了Bootstrap、Foundation和Material Design Lite模板，您可以立即开始使用。这也可以通过设置进行切换。

• 数据库

  • 可以通过切换到SQL数据库（SQLite、MySQL、PostgreSQL）、MongoDB和Google Cloud Datastore来使用数据库。
  • 应用程序采用声明性事务的标准Repository方法进行访问。对于ORM方法，将准备另一个骨架。

• 访问控制

  • 包括Web应用程序的示例用户身份验证和访问控制。
  • 虽然 Rindow 框架的访问控制对所有应用程序都可用，而不仅仅是基于 Web 的应用程序，但此示例演示了使用表单身份验证的 Web 应用程序的访问控制。

• REST Api 应用程序

  • 包括带有 Vue.js 的 REST Api 应用程序示例。

• 命令行应用程序

  • 包括用于数据库维护的命令行应用程序示例。

要求

此示例是为 PHP 7.2 及以上版本创建的。

然而，Rindow 框架支持 PHP 5.3.3 及以上版本。您可以通过仅重写 PHP 5.x 的示例代码来使用 Rindow 框架的相同功能。

安装

使用 Composer（推荐）

如果您没有 Composer，请从 https://getcomposer.org.cn/ 下载，或直接运行以下命令

$ php -r "readfile('https://getcomposer.org.cn/installer');" | php

然后，使用 create-project 命令生成一个新项目

  php composer.phar create-project rindow/skeleton-fullfeatures-demo path/to/install

Composer 将在 path/to/install 目录下安装 Rindow Web 应用骨架及其依赖项。

从 Github 下载

您也可以直接从 github 下载。

  $ git clone https://github.com/rindow/skeleton-fullfeatures-demo path/to/install
  $ cd path/to/install
  $ composer update

设置和运行骨架应用程序

设置数据库。默认设置为 SQLite。

    $ cd path/to/install
    $ bin/myapp create-schema

或者完成数据库设置后...

    $ bin/myapp create-schema -s | mysql -u username -p database_name

（数据库设置在 config/local/database.sql.php.disable 中描述。）

设置受保护页面的用户。

    $ bin/myapp user-add -p password test@test.com

运行应用程序。

    $ php -S localhost:8000 -t public

现在示例正在运行。使用 Web 浏览器访问 http://localhost:8000/。

更改设置

我们已准备好一个更改模板，以便您可以轻松更改设置。请在config/local/下启用每个设置。

设置已编译并保存。更改设置后，您必须清除缓存。在示例中已准备脚本。如果您正在使用APCu等内存缓存，也请清除内存缓存。

如果您更改webapp.config.php中module_manager部分的版本项，缓存将自动清除。

更改页面主题

    $ mv config/local/theme.mdl.local.php.disable config/local/theme.mdl.local.php
    $ bin/cache-clear

更改模板引擎

    $ mv config/local/template.smarty.local.php.disable config/local/template.smarty.local.php
    $ bin/cache-clear

更改数据库平台

    $ mv config/local/database.mongodb.local.php.disable config/local/database.mongodb.local.php
    $ bin/cache-clear