Manual:Tutorial/Hello World/zh

From Kiwiphp

Jump to: navigation, search

提示

kiwiphp只能运行于php5下, 请先阅读系统需求

按照本文档操作时,请不要改动目录结构和文件名称,这能保证您以最快的速度成功入门。
您可以阅读了kiwi的详细文档,知道如何改之后再来改。

Contents

安装kiwiphp

下载kiwiphp的源代码,解压到您的电脑上的任意一个目录下(比如:C:\kiwiphp).

目录结构如下:

C:\kiwiphp
├─example
├─runtime
├─tests
└─tool

提示
这些目录下都有什么?起什么作用?您可以在成功运行"Hello World"之后参考目录结构kiwiphp框架自身的目录结构部分。

运行"Hello World"

进入命令行模式,切换目录至 example\cli_entrance, 以cli方式运行tool.php (假设php解释器位于 C:\php\php.exe):

C:\php\php.exe C:\kiwiphp\example\cli_entrance\tool.php --module hello --action HelloWorld

屏幕上将显示一条“Hello World”。

创建第一个项目

项目目录结构

在您的网站根目录创建如下目录结构(本例的网站根目录是 C:\apache\htdocs)。

C:\apache\htdocs\1st_kiwi_proj
├─app
  └─frontend
     └─module
        └─hello
           └─action
              └─HelloWorldAction.php
└─entrance
    └─web
       └─frontend.php
打开命令行窗口,进入你的网站根目录,然后用下面的命令可以帮你快速建好hello world示例所需的目录和文件:
  • Windows

mkdir 1st_kiwi_proj\app\frontend\module\hello\action
type nul > 1st_kiwi_proj\app\frontend\module\hello\action\HelloWorldAction.php
mkdir 1st_kiwi_proj\entrance\web
type nul > 1st_kiwi_proj\entrance\web\frontend.php
  • Linux/BSD

mkdir 1st_kiwi_proj\app\frontend\module\hello\action
echo "" > 1st_kiwi_proj\app\frontend\module\hello\action\HelloWorldAction.php
mkdir 1st_kiwi_proj\entrance\web
echo "" > 1st_kiwi_proj\entrance\web\frontend.php

入口文件

打开文件 C:\apache\htdocs\1st_kiwi_proj\entrance\web\frontend.php, 加入如下代码:

<?php
include('C:/kiwiphp/runtime/kiwi.php');
Kiwi::run();

提示

有的用户按此文档实践时将frontend.php的名字改成了index.php,结果未能成功运行。这是因为frontend.php的名字和app/frontend目录存在映射关系的,如果改了入口文件的名字,只需要给Kiwi::run()一个参数即可正常运行:Kiwi::run(array('app_name' => 'frontend'));

入口文件和app_name之间的映射关系参看"入口文件"文档"app_name"部分

Hello World Action

打开文件 C:\apache\htdocs\1st_kiwi_proj\app\frontend\module\hello\HelloWorldAction.php, 加入如下代码:

<?php
class HelloWorldAction extends Action
{
    public function execute()
    {
        echo "Hello World!";
    }
}

提示

为什么示例中所有的php文件末尾都没有php闭合标签“?>”?

kiwiphp的编码规范中有个约定:除了View,其他PHP文件省略PHP闭合标签

运行

web方式运行

打开浏览器,地址栏键入: http://localhost/1st_kiwi_proj/entrance/web/frontend.php?module=hello&action=HelloWorld

页面将显示“Hello World!”。

命令行方式运行

进入命令行模式,执行以下命令:

C:\php\php.exe C:\apache\htdocs\1st_kiwi_proj\entrance\web\frontend.php -m hello -a HelloWorld

提示
在上一个章节,我们使用--module和--action,这里却使用-m和-a,这两种方式都可以工作的,详情请查看kiwiphp的用法文档的"命令行"章节

屏幕上将显示“Hello World!”。

恭喜,您的第一个基于kiwiphp的项目运行成功!