Yod Framework 用户手册(一)

原创
2014/02/17 12:58
阅读数 654

1.1 关于Yod

Yod是一个C语言编写的PHP框架,Yod同时支持单入口和多入口模式,应用灵活,形式自由


1.2 Yod安装/配置

Yod只支持PHP5.2及以上的版本

1.2.1 编译Yod

$PHP_BIN/phpize
./configure --with-php-config=$PHP_BIN/php-config
make
make install

1.2.2 以debug模式编译Yod

$PHP_BIN/phpize
./configure --enable-yod-debug --with-php-config=$PHP_BIN/php-config
make
make install


1.3 Yod定义的常量

YOD_VERSION	Yod框架的三位版本信息
YOD_RUNTIME	Yod框架的开始运行时间
YOD_FORWARD	forward最大嵌套深度
YOD_RUNMODE	Yod框架的运行模式(按位标记:1 自动运行,2 记录错误日志,4 显示Debug信息(仅在debug模式下有效),8 记录Debug信息(仅在debug模式下有效))
YOD_CHARSET	输出的字符编码方式
YOD_VIEWEXT	视图文件的扩展名(默认:.php)
YOD_PATHVAR	获取uri路由信息的变量名
YOD_EXTPATH	Yod框架的扩展文件(数据库驱动等)的路径
YOD_LOGPATH	Yod框架的日志存储目录
YOD_RUNPATH	APP的运行目录(定义了此常量后自动运行模式才会生效)


1.4 Hello World!

这是一个简单的模式,只有两个文件

hello.php

<?php 
//set_time_limit(0); 
error_reporting(E_ALL); 
date_default_timezone_set('Asia/Shanghai'); 

defined('YOD_VIEWEXT') or define('YOD_VIEWEXT''.tpl'); 
defined('YOD_RUNPATH') or define('YOD_RUNPATH'dirname(__FILE__)); 

class 
HelloController extends Yod_Controller 

    public function 
init() 
    { 
        
$this->_name ''
        
$this->_view['tpl_path'] = YOD_RUNPATH
    } 

    public function 
indexAction() 
    { 
        
$this->assign($content'Hello World!'); 
        
$this->display('hello'); 
    } 

    public function 
errorAction() 
    { 
        echo 
'<pre>'
        
print_r($this); 
    } 


hello.tpl

<html> 
  <head> 
    <title>Hello World!</title> 
  </head> 
  <body> 
    <?php echo $content?> 
  </body> 
</html>


1.5 Yod目录结构

Yod的目录结构比较灵活

1.5.1 标准目录结构

- index.php // APP 入口
+ public
+ yodphp
    + drivers   // 数据库驱动
+ app
    + actions   // Other actions
    + configs
        - config.php    // 配置文件
    + controllers
        - IndexController.php   // 控制器
    + extends   // APP扩展
    + models    // 模型
        - DemoModel.php
    + views
        + index // 视图
            - index.php

1.5.2 多入口目录结构

- index.php // index 入口(一般情况控制器会写在入口文件里,参考Hello World!)
- hello.php // hello 入口
+ public
+ app

1.5.3 精简目录结构

- index.php // index 入口(require configs.php, controllers.php, models.php)
+ public
+ app
    - configs.php
    - controllers.php
    - models.php
    + views
        + index // 视图
            - index.php


1.6 Yod应用的配置结构

Yod应用配置的结构比较灵活

1.6.1 标准配置结构

- index.php // APP 入口
+ app
    + configs
        - config.php    // 配置文件

1.6.2 多文件配置结构

- index.php // APP 入口
+ app
    + configs
        - base.config.php    // 配置文件
        - db_dsn.config.php  // 数据库配置
        ...

1.6.3 使用$config变量配置

全局变量$config会覆盖其他方式的配置值


2.1 Yod_Application

Yod_Application 代表一个产品/项目, 是Yod运行的主导者, 真正执行的主题. 它负责接收请求, 协调路由, 分发, 执行, 输出.

主要方法: run,config,import,app,autoload


2.2 Yod_Request

Yod_Request 代表了一个实际请求, 一般的不用自己实例化它, Yod_Application 会自动根据当前请求实例它.

主要方法: route,dispatch,errorAction,error404


2.3 Yod_Controller

Yod_Controller 是Yod的MVC体系的核心部分, 可以通过继承已有的类, 来实现这个抽象类, 从而添加应用自己的应用逻辑.

主要方法: config,import,model,dbmodel,assign,render,display,widget,forward,redirect,error404


2.4 Yod_Action

Yod_Action 是MVC中C的动作, 一般而言动作都是定义在Yod_Controller的派生类中的, 但是有的时候, 为了使得代码清晰, 分离一些大的控制器, 则可以采用单独定义Yod_Action来实现.


2.5 Yod_Widget

Yod_Widget 在MVC中V的一些公共的部分可以采用单独定义Yod_Widget来实现.


2.6 Yod_Model

Yod_Model 是Yod的MVC体系的核心部分, 可以通过继承已有的类, 来实现这个抽象类, 从而添加应用自己的应用模型.

主要方法: getInstance,find,select,count,save,update,remove,lastQuery,config,import,model,dbmodel


2.7 Yod_DbModel

Yod_DbModel 是Yod的MVC中M的扩展, 可以通过继承已有的类, 来实现这个抽象类, 从而添加应用自己的应用模型.

主要方法: getInstance,table,find,select,count,save,update,remove,field,from,join,where,group,having,order,limit,union,comment,params,parseQuery


2.8 Yod_Database

Yod_Database 是Yod的数据库驱动抽象类, 可以通过继承已有的类, 来实现这个抽象类, 从而添加应用自己的数据库驱动.

主要方法: db,getInstance,config,create,insert,update,delete,select,lastQuery


2.9 Yod_DbPdo

Yod_DbPdo 是Yod的数据库PDO驱动类,实现了对PDO的简单封装.

主要方法: connect,fields,execute,query,count,fetch,fetchAll,transaction,commit,rollback,insertid,quote,free,close,errno,error


展开阅读全文
加载中
点击引领话题📣 发布并加入讨论🔥
打赏
0 评论
6 收藏
0
分享
返回顶部
顶部