README

安装

Composer

最简单的安装方法是使用 Composer

在您的 composer.json 文件中

{
	"require": {
		"php": ">=5.3.0",
		"kengoldfarb/underscore_php": "1.*",
	}
}

或者，您可以直接 下载源代码

入门

该框架遵循MVC模式，所有路由都在Web服务器级别完成。

享受 _PHP 的最佳方式是与 _Libs 结合使用，这可以通过Composer安装（这是默认的）

{
	"require": {
		"php": ">=5.3.0",
		"kengoldfarb/underscore_libs": "1.*",
	}
}

控制器（和基本路由）

创建友好的URL非常简单。

https:/// 映射到 controllers/defaultController.php [action=index]

https:///hellothere 映射到 controllers/defaultController.php [action=hellothere]

https:///lists 映射到 controllers/listsController.php [action=index]

https:///lists/add-list 映射到 controllers/listsController.php [action=add-list]

等等...

只需查看 controllers/defaultController.php 以获取示例。

对于自定义路由，请查看 .htaccess 文件和 nginx 示例配置文件

模型

模型应创建在 models/ 中，然后正常使用

require_once _MODELS . 'MyModel.php';
$myModel = new MyModel();

视图

视图由控制器包含。这允许您有很大的灵活性来创建布局。

include _VIEWS . 'header.php';
include _VIEWS . 'myview.php';
include _VIEWS . 'footer.php';

请参阅 views/ 目录和 defaultController.php 以获取示例

配置

环境

特定环境的配置选项可以定义在位于 src/env/ 的文件中

将您的服务器名称映射到环境在 src/config/environments.php 中发生

常量

_PHP 定义了一些在代码中使用的便利常量。

_WEBROOT Web根目录的完整路径 (/path/to/project/src/www)

_MODELS Web根目录的完整路径 (/path/to/project/src/www/models)

_CONTROLLERS Web根目录的完整路径 (/path/to/project/src/www/controllers)

_VIEWS Web根目录的完整路径 (/path/to/project/src/www/views)

版本控制

您可以在 src/config/version.php 文件中设置版本。这对于缓存清除特别有用。

带有版本号的任何内容都将路由到相应位置。

例如

http://local.underscorephp.com/v1.2.3/css/bootstrap-responsive.css 与 http://local.underscorephp.com/css/bootstrap-responsive.css 相同

http://local.underscorephp.com/v1.2.3/underscore_php 与 http://local.underscorephp.com/underscore_php 相同

Web服务器配置

请查看.apache的 .htaccess 文件。Nginx 即将推出...

许可

GNU通用公共许可证第3版