PHP-GTK 介绍及其应用

March 23,2004

1. PHP-GTK介绍

1.1 PHP-GTK
PHP-GTK是PHP的延伸模组，它可以让程式设计师写出在客户端执行的、且独立的GUI的程式。这个模组不允许在浏览器上显视GTK+的程式，它一开始就是开发来写独立的GUI程式的。

1.2 GTK
GTK原本是为GIMP，一个GUI的影像处理软体而开发的。GTK+是GIMP的套装工具。GTK+从这里开始发展，直到现在已经成为Gnome的中心(Gnome是一个桌面环境)。後来GTK+也已经被推广到BeOS和Win32，使得它成为PHP延伸模组的最佳选择，维持PHP可以跨平台并可以用PHP为Linux,BeOS,Windows等平台开发视窗介面的程式。

2. PHP-GTK概念

2.1 前言
接下来就要教各位一点点比较观念性的东西罗┅因为这章的概念都是非常重要的，所以就算不懂，也还是要慢慢的看懂它，不然┅以後就┅。还有，接下来的内容不建议没有程式设计经验的读者阅读，因为有很多的观念很容易会搞不清楚。还有，接下来该用英文的部分我都会用英文，这样大家在看国外文件的时候才不会不知所措，加油吧!!如果对本章有任何不懂之处，请自行查阅
PHP-GTK Manual：http://gtk.php.net/manual/en/

2.2 Widget(s)
Widget是一个GUI程式中基本的functions和forms。最常用的几个Widget是：label、button、window、frame和text box。所有的widget都是来自於一个抽象的基本class─GtkWidget。每个widget都是一个class

一个Widget一生大概都有五个时期：
1. 建立(Creation)：宣告一个物件(declaring an object)
2. 放置(Placement)：将它加入一个容器中(adding it to a container)
3. 信号连接(Signal Connection)：接收信号以及进行动作(the action it will perform)
4. 显示(Display)：它是否是可见的(whether it is viewable or not)
5. 删除(Destruction)：关闭程式(closing of a program)

2.3 Container(s)
Container是一个可以包含其他widget的widget。大部分的widget都是container，例如：GtkWindow、GtkTable和GtkBox。除了这点之外，container跟其他的widget没两样，也可以被放到其他container去。而所有的container都是来自於一个class─GtkContainer，本身来自於GtkWidget的class。所以container也是widget的一种。

2.4 Signal(s)
当程式设计师在程式中做了一个动作时，程式需要有一个动作来回应使用者的动作。Signals使程式可以知道使用者做了动作并可以触发适合的回应。

例如，当使用者按了一个可以开新视窗的按钮(GtkButton)，程式认出这个请求，於是就开了一个新的视窗。这件事可以经由signal来做到。当按钮按下去之後，会使widget发出一个signal，接着再由该signal触发callbacks，产生一个新的视窗(GtkWindow)。

2.5 Callback(s)
Callback就是当signal送出之後，被signal唤起的function。Callback会执行function传回一个值或是做一个动作。Callback就是signal的handler funciton。它可以是该signal的预设handler或着是程式设计师定义的function。要建立一个callback，就必须把function connect 到 signal。

2.6 Signal Inheritance(继承)
和methods一样，signals可以被物件继承。一个widget可以送出任何它的parent widget可以送出的还有它自己特有的signal。

2.7 Connecting Signals
你必须为PHP-GTK指定一个callback function当signal送出时来对signal做回应。把一个signal连接到一个function可以用connect() 这个object 方法达成。

如下：

<?php
//建立一个GtkWindow
$window = &new GtkWindow();
//将"destroy" signal用connect() 方法连接到shutdown函式
$window->connect("destroy", "shutdown");
//建立一个GtkButton，按钮文字为"按我"
$button = &new GtkButton("按我");
$button->connect("clicked", "you_clicked");
//把GtkButton放到是container的GtkWindow中
$window->add($button);
//显示$window以及它的所有child widget
$window->show_all();
//进入程式主回圈(即程式启动之意)
gtk::main();
?>

执行它的话，就会出现一个视窗，里面有一个写着"按我"的按钮，按下按钮程式就会执行you_clicked函式。在这个程式中，$window物件的"destroy" signal是在使用者按下视窗右上角的"X"时会送出的；而$button物件的"clicked" signal是在使用者按下该按钮的时候会送出的。最後那一行的gtk::main() 是一定要执行的，这样才能告诉电脑要开始执行程式，既然有开始执行，那就一定有停止吧? 没错，用gtk::main_quit() 就可以停止程式了。

看完了以上的范例，有些读者可能会有疑问「如果我想执行送出signal的widget之外的widget的method怎么办?」，这时候，就要用另一个method了 a connect_object()，它可以跨物件呼叫方法或是传递其他物件做为function的叁数。跨物件呼叫方法如下：

$window->connect_object("destroy", array("gtk","main_quit"))

如此，在$window物件的"destroy" signal送出的时候就会唤起gtk::main_quit()这个方法，程式就会终指执行。

在介绍连接方法的最後，再提一下connect() 和 connect_object() 的自订增加要传给callback function的叁数的办法。见例子：
<?php
$parameter="新超人";
$button1 = &new GtkButton("测试");
//将"clicked" signal连接到who_are_you函式，附加叁数$parameter
$button1->connect("clicked","who_are_you",$parameter);
$button2 = &new GtkButton("测试二");
//将"clicked" signal连接到kill_the_button1函式，附加叁数$button1
$button2->connect_object("clicked","kill_the_button1",$button1);

function who_are_you($widget,$parameter){
echo $parameter;
}

function kill_the_button($button){
$button->destroy();
}
?>

注意那两个function，who_are_you有两个叁数对吧? 第一个是做什么用的呢?为什么它会自动出现?? 因为，每个signal的callback function都会因为signal的不同而加上一些内定一定会传入callback function的叁数，而基本上所有的signal都至少会传给callback function一个叁数a产生该signal的物件。所以who_are_you的第一个叁数就是$button1，而第二个就是$parameter，也就是新超人。那kill_the_button函式就不一样罗~ 因为connect_object()函式会呼略原本signal的callback function的预设叁数，所以kill_the_button就只有附加在connect_object最後的$button1叁数了，如此，kill_the_button就可以呼叫$button1的方法或是取得它的属性，这里呼叫了$button1的destroy方法，於是$button1就会被消灭。

2.8 Event(s)
Event是signal的一种，但是它的用途还有功能都非常强大。就signal来说，signal这种东西都是内建在widget上的，所以，例如GtkWindow没有"clicked"signal，那么在不用event signal的情况下，GtkWindow是决对不可能送出clicked之类的signal的。那如果用了event signal呢? Event signal是可以允许被加到任何的widget上的，所以就算这个widget本来没有发出"clicked"signal的功能，你也可以用add_events() 来为它加上按了它之後event signal会做什么样的反应。而event signal中包含的资讯比较多，比如说当你在使用"key-press-event"这个event signal的时候，同时也会记录到你按下的是什么按键，於是通常event signal的callback function格式内定会有两个叁数，第一个依然是送出signal的widget，而第二个就是$event，这个$event是一个class，里面的属性和方法会因为送过来的event signal种类而不同。就"key-press-event"传回的$event class来说，里面有一个属性是keyval，内容就是使用者按的是哪一个键。这些对於一个程式设计师来说常常是很有用的资讯。所以event的重要性是不可忽视的，就算刚开始会有点不懂，也要慢慢的融入才行。这一节也非常重要。

3. 安装PHP-GTK

3.1 在Windows系统下安装
首先要从http://gtk.php.net/download.php下载...HP-GTK的windows binary档案(本文撰写时为0.5.1版)。

接着来看看PHP-GTK 0.5.1 binary档的内容：
php4 → php 和 php-gtk binary 档案
winnt → 预设的php.ini档案
winntsystem32 → gtk binaries used by extension
test → 几个测试用的档案
README.txt → 安装说明档

开始安装：
1. 复制 php4 的内容到你的php安装目录下(例C:php)。
2. 复制 winnt 的内容到你的winnt资料夹。在Windows NT或Windows2000上是C:winnt，在Window95、98、xp上是C:windows。如果该资料夹里已经有 php.ini，那就不用做这个动作。
3. 复制 winntsystem32 的内容到你的winntsystem32资料夹。在Windows NT或Windows2000上是C:winntsystem32，在Window95、98、xp上是C:windowssystem32。
4. 复制 test 的内容到你想要执行你的script的地方(此步骤非必要)。

如何执行PHP-GTK程式：
PHP-GTK程式可以在「开始」-「执行」下输入指令(或是建立捷径)来启动，如：C:phpphp -q c:phptestgtk.php ## 表示不送印出 HTTP Header，但一直使用这个视窗，直到关闭程式。
C:phpphp -q -c php.ini c:gtk.php ## 同上，但执行指定的php.ini设定。
C:phpphp C:phptestgtk.php ## 表示会送印出 HTTP Header，但一直使
用这个视窗，直到关闭程序
C:phpphp_win C:phptestgtk.php ## 表示不使用视窗，执行後独立一个执行程式，他是使用 php -q模式，但是只要output出任何字元，例如错误讯息，就会停止执行。

3.2 在UNIX系统下安装
Debian的使用者可以在 http://www.debian.org 下载PHP-GTK的binary档。系统需求须已安装下列package：

PHP 4.1.0 或之後的版本，必须是编为CGI binary(command-line) 版本，包含所有的header files和devlement scripts。

PHP-GTK支援GTK+ v1.2而需要安装1.2.6以上版本的GTK+。GTK+ v2.0还未被支援，必须等到它开发完成并且普及了之後才会被支援。你可以从下面的网址取得GTK+ v1.2.X的最新版本：ftp://ftp.gtk.org/pub/gtk/v1.2/

在将取得的档案解压缩或是由CVS中check out出来之後，切换到该目录下，开始进行安装(打指令罗~)：

取得CVS版本，执行
cvs -d server:[email protected]:/repository co php-gtk
或下载最新版本
http://gtk.php.net/download.php

1. ./buildconf
2. ./configure (想要加装extensions的话请输任./configure --help看说明)
3. make(如果看到"Could not write┅"，只是代表该GTK+ object还没被支援，不算是什么错误讯息)
4. make install

执行看看test/资料夹中的范例scripts来测试，特别是gtk.php，这些都是展示如何使用的好例子。

4. 第一支程式

4.1 前言
本章会教导各位一些常用的GtkClass(widget)，还有运用这些来做出你的第一支PHP-GTK程式，如果概念那章不是很熟的话，这章可以给你一个练习的机会喔! 如果对本章的内容有不懂或是想要深入了解其他的widget，可以到http://gtk.php.net/manual/en/ 看手册，手册里面有不少范例程式。

4.2 会用到的widgets
在开始写程式之前，先来对等一下会用到的widget class们做一个overview。

GtkWindow()
GtkWindow()建立一个视窗，里面有很多方法可以使用，如：set_title,set_name,
connect,set_border_width等┅。

GtkFrame()
GtkFrame()纯粹建立一个好Border，你可以设定它的label name,alignment,
shadow(用英文，读Manual的时候会比较方便)。

GtkVBox()
GtkVBox()建立一个直立的container来放入widgets。

GtkLabel()
GtkLabel()可以建立一个label，内容文字可以建立时设定也可以建立後用方法来设定，如果没有设定内容文字，将会建立一个空的label(这是废话吗┅?)。

GtkHSeparator()
GtkHseparator()建立一个水平线。

GtkEntry()
GtkEntry()建立一个textbox供使用者输入资讯。

GtkHButtonBox()
GtkHButtonBox()建立一个以水平方式排列Button的container。

GktBtton()
GtkButton()或许可以说是GUI程式中最常用的widget了，它建立一个可以让使用者按的按钮。

4.3 开始

If(!class_exist("gtk"))
{
dl("php_gtk.".(strstr(PHP_OS,"WIN") ? "dll" : "so"));
}

这段程式码会判断PHP-GTK延伸模组是否已启动，如果没有，它就会读取适当的档案。在上面的范例中，是靠判断执行的作业系统是Windows还是其它来判断要载入php_gtk.dll还是php_gtk.so。

Function delete_event()
{
return false;
}

这里建立了一个名为delete_event的function，这个function是等会儿delete-event signal发出时的callback function。内容传回false会告诉PHP-GTK用预设的signal handler来处理，而预设的handler会关闭视窗(同时会呼叫该视窗的destroy() 函式)，在这里，它会关闭程式(因为这个范例程式只有一个主视窗，一旦关闭就会关闭程式)。

Function destroy()
{
Gtk::main_quit();
}

这里建立了一个函式，destroy()。在这个程式中，这个函式是很重要的，因为我们在关闭程式的时候会连接到它。之前说过，Gtk::main_quit()会关闭程式，如果我们在这个程式中没有定义这个function或是这个function里面没有Gtk::main_quit()这行，那么这个程式就不会关闭了。以上一段程式码说明里提到的delete-event来说，return false之後预设会执行关闭视窗的动作，还会呼叫destroy()函式，如果这里没有定义或是没有Gtk::main_quit()这段的话，主视窗的确会关闭，可是程式并不会结束，因为主程式回圈aGtk::main()还在跑。

<?php
$window = &new GtkWindow();
//设定名字以辨别各个视窗
$window->set_name('main window');
//设定视窗的标题
$window->set_title('对PHP-GTK的介绍');
//设定视窗的大小
$window->set_usize(160, 120);
//呼叫destroy()函式来结束程式
$window->connect('destroy', 'destroy');
//呼叫delete_event()函式来关闭视窗
$window->connect('delete-event', 'delete_event');
//设定视窗的边框宽度
$window->set_border_width(10);
//设定视窗的位置
$window->set_position(GTK_WIN_POS_CENTER);
//显示视窗和所有child widget (不显示就看不到)
//最後这两行一定要放在程式码的最後，否则什么都看不到
$window->show_all();
Gtk::main();
?>

执行程式可以看到如下的图：

500) this.width=500' align='center' hspace='10' vspace='10'>

//建立一个GtkFrame
$frame = &new GtkFrame('经过简易修改的程式');
//把GtkFrame放到GtkWindow里
$window->add($frame);
//最下面两行不要动

结果如下图：

500) this.width=500' align='center' hspace='10' vspace='10'>

下面这段建立一个GtkVBox作为container，并把GtkEntry、GtkHSeperator、GtkLabel和GtkButtonBox都pack进去，所谓pack，是GtkBox底下的container们特别加入的放入widget的方法，就类似於add()，而pack用的方法一般是pack_start()和pack_end()，比add()好的地方是可以控制将widget增加进去之後widget的位置(不过只要是container就会有add()方法)，欲查询详细资料请至
http://gtk.php.net/manual/en。

//建立一个GtkVBox，为常用的container
$box1 = &new GtkVBox();
//把GtkVBox放到GtkFrame里面
$frame->add($box1);
//建立一个GtkLabel并将它pack到GtkVBox里
$label = &new GtkLabel();
$box1->pack_start($label);
//建立一个GtkHSeparator并将它pack到GtkVBox里
$separator = &new GtkHSeparator();
$box1->pack_start($separator);
//建立一个GtkEntry并将它pack到GtkVBox里
$entry = &new GtkEntry();
$box1->pack_start($entry);
//建立一个GtkButtonBox并将它add到GtkVBox里
//因为GtkButtonBox也是一个无形的container，位置不重要，所以用add()
$box2 = &new GtkHButtonBox();
$box1->add($box2);

执行如下图：

500) this.width=500' align='center' hspace='10' vspace='10'>

最後这段程式码会建立两个GtkButton并pack到GtkButtonBox里去，还有为两个按钮加上连接，使它们起作用，并建立一个函式，只要按下GtkButton就会将GtkLabel的内容换成GtkEntry中的文字。

$button = &new GtkButton('显示输入的字');
//连接"clicked" signal到set_name()函式，附加$label和$entry两个widget
$button->connect_object('clicked','set_name',$label,$entry);
$box2->pack_start($button);
$button = &new GtkButton('离开程式');
//连接"clicked" signal到destroy()函式，将会关闭程式
$button->connect('clicked','destroy');
$box2->pack_start($button);

function set_name($label,$entry)
{
//用GtkEntry的get_text()方法从取得文字方块内容
$gettext=$entry->get_text();
//用GtkLabel的set_text()方法设定新的文字
$label->set_text($gettext);
}
//最後再提一下那两行┅.
$window->show_all();
Gtk::main();

寫到這裡，整個程式就算是完成了，來看看執行的結果吧~

500) this.width=500' align='center' hspace='10' vspace='10'>
500) this.width=500' align='center' hspace='10' vspace='10'>

5. 其它

5.1 进一步学习
   如果在结束了上面的课程之后你还想要更了解PHP-GTK，或是对于本文的内容有任何
   不明白的地方，这里提供你几个地方可以查询资料：

   PHP-GTK官方网站(En)： http://gtk.php.net
   GTK官方网站(En)： http://www.gtk.org
   PHP-GTK官方网站上的Manual(En)： http://gtk.php.net/manual/en
   TIM官方网站(zh-Tw)： http://tim.jerry.com.tw

5.2 另一个范例
   这里有一个笔者写的猜数字游戏，算是比较进阶的范例，可以抓回去研究看看。
   http://pc035860.infor.org/download/GuessNumber.zip

5.3 参考数据
   本文主要是参考PHP-GTK官方Manual和Zend网站上的Tutorial而编撰成的：
   http://gtk.php.net/manual/en
   http://www.zend.com/zend/tut/tutorial-silva.php
5.4 关于作者
   无敌铁金刚(自称)，目前(2002/08/18)是台北市立建国中学一升二年级的学生，在
   学校参加了信息社，这篇文章就是放在社刊上的。

建国中学 - 资优生 - 无敌铁金刚 Robins <[email protected]>