3.2. Hello World

你也可以使用Yaf的代码生成器: yaf_cg 来快速的构建一个应用例子.

目录结构

对于Yaf的应用, 都应该遵循类似下面的目录结构.

例 3.1. 一个典型的目录结构


+ public
  |- index.php //入口文件
  |- .htaccess //重写规则    
  |+ css
  |+ img
  |+ js
+ conf
  |- application.ini //配置文件   
+ application
  |+ controllers
     |- Index.php //默认控制器
  |+ views    
     |+ index   //控制器
        |- index.phtml //默认视图
  |+ modules //其他模块
  |+ library //本地类库
  |+ models  //model目录
  |+ plugins //插件目录


入口文件

入口文件是所有请求的入口, 一般都借助于rewrite规则, 把所有的请求都重定向到这个入口文件.

例 3.2. 一个经典的入口文件public/index.php


<?php
define("APP_PATH",  realpath(dirname(__FILE__) . '/../')); /* 指向public的上一级 */
$app  = new Yaf_Application(APP_PATH . "/conf/application.ini");
$app->run();

    


重写规则

除非我们使用基于query string的路由协议(Yaf_Route_Simple, Yaf_Route_Supervar), 否则我们就需要使用WebServer提供的Rewrite规则, 把所有这个应用的请求, 都定向到上面提到的入口文件.

例 3.3. Apache的Rewrite (httpd.conf)


#.htaccess, 当然也可以写在httpd.conf
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule .* index.php

    


例 3.4. Nginx的Rewrite (nginx.conf)


server {
  listen ****;
  server_name  domain.com;
  root   document_root;
  index  index.php index.html index.htm;

  if (!-e $request_filename) {
    rewrite ^/(.*)  /index.php/$1 last;
  }
}

    


例 3.5. Lighttpd的Rewrite (lighttpd.conf)


$HTTP["host"] =~ "(www.)?domain.com$" {
  url.rewrite = (
     "^/(.+)/?$"  => "/index.php/$1",
  )
}

    



例 3.6. SAE的Rewrite (config.yaml)


name: your_app_name
version: 1
handle:
    - rewrite: if(!is_dir() && !is_file() && path ~ "^(.*)$" ) goto "/index.php"
    


[注意] 注意
每种Server要启用Rewrite都需要特别设置, 如果对此有疑问.. RTFM

配置文件

在Yaf中, 配置文件支持继承, 支持分节. 并对PHP的常量进行支持. 你不用担心配置文件太大造成解析性能问题, 因为Yaf会在第一个运行的时候载入配置文件, 把格式化后的内容保持在内存中. 直到配置文件有了修改, 才会再次载入.

例 3.7. 一个简单的配置文件application/conf/application.ini


[product]
;支持直接写PHP中的已定义常量
application.directory=APP_PATH "/application/" 

     


控制器

在Yaf中, 默认的模块/控制器/动作, 都是以Index命名的, 当然,这是可通过配置文件修改的.

对于默认模块, 控制器的目录是在application目录下的controllers目录下, Action的命名规则是"名字+Action"

例 3.8. 默认控制器application/controllers/Index.php


<?php
class IndexController extends Yaf_Controller_Abstract {
   public function indexAction() {//默认Action
       $this->getView()->assign("content", "Hello World");
   }
}
?>

    


视图文件

Yaf支持简单的视图引擎, 并且支持用户自定义自己的视图引擎, 比如Smarty.

对于默认模块, 视图文件的路径是在application目录下的views目录中以小写的action名的目录中.

例 3.9. 一个默认Action的视图application/views/index/index.phtml


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

    


运行

例 3.10. 在浏览器输入


http://www.yourhostname.com/application/index.php

    


看到了Hello World输出吧?

[注意] 注意
我没有看到Hello world

如果没有看到, 那么请查看PHP的错误日志, 找出问题在哪里.