[Pyramid]【PocketMine】插件制作学习&讨论

本帖最后由 hsk001ufo 于 2014-1-19 14:25 编辑

声明：本人对于PocketMine及php认知有限在这里分享一下一年来对PocketMine的经验

本帖由NES工作室成员kgdwhsk发布

开发准备

首先学习php及编写PocketMine（下文开始以PM简称）的插件我们需要一个代码编辑器（Windows系统推荐Notepad++下载可以去Notepad++官网：notepad-plus-plus.org下载），虽然代码在什么编辑器上都行，不过用这些专用的编辑器可以提高代码可读性并且增加效率。PM是基于php编写的一个软件，想要编写PocketMine的插件就必须会一些php的语法（在PM中特别需要熟练类[class]即面向对象的知识）如果你是一个php新手（比如我）可以上www.codecademy.com学习php的一些基础，这个网站是在边实践边学的所以本人觉得不错暑假时就是这个网站让我再次提起了对php的学习兴趣。

了解PM插件

现在我们可以上pm的官网看看：

在这里我们可以下载到PM最新的版本及很多PM资讯，你也可以进入PM论坛看看那里有许多有趣的插件。

接下来我们进入https://github.com/PocketMine/PocketMine-MP就可以获取最新pm测试版还有很多关于pm的信息。

我们可以在Github上找到这个https://github.com/PocketMine/PocketMine-MP/wiki/Plugin%20format在这里可以看到pm作者留下的插件的格式：

这里就是PM插件的开头部分，虽然在PHP里面/* */是注释的作用不过PM会检测这段信息，如果填写错误就会导致插件启动失败，name代表的是插件的名字，在PM开启时插件名字就是从这而来，version就是代表插件的版本号，那个description写的是关于此插件的功能介绍，autuhr就是写作者名字，class这个需要和你的插件类名字一样，apiversion这个填写的是PM的API版本。（以上除了class需要与代码里面的类名相同外其他根据个人意愿填写基本不会造成插件出现问题）

这就是Wiki里面的范例插件：

<?php
/*
__PocketMine Plugin__
name=ExamplePlugin
version=0.0.1
description=Example plugin
author=shoghicp
class=ExamplePlugin
apiversion=7
*/
class ExamplePlugin implements Plugin{
private $api;
public function __construct(ServerAPI $api, $server = false){
$this->api = $api;
}
public function init(){
$this->api->console->register("example", "Example command", array($this, "handleCommand"));
}
public function __destruct(){
}
public function handleCommand($cmd, $arg){
switch($cmd){
case "example":
console("EXAMPLE!!!");
break;
}
}
}
?>

复制代码

class ExamplePlugin implements Plugin{这是插件主体的第一句，意思就是定义一个类使用了Plugin（这个接口在src/API/PluginAPI.php）接口。

然后我们可以在/src/PluginAPI.php里面找到这个接口（接口的意义就在于像pm插件这样固定一个模板）

这样我们就可以看出插件的必备组成部分，这三个必须要有

$this->api->console->register()就是注册指令还有指向输入这个命令时使用的方法，这是pm内部的一个函数我们引用这个函数来进行注册命令白名单，example是指令名，后面那一段"Example command"是在输入help时显示的指令介绍，当控制台或者玩家使用example（玩家是使用/example）这个命令时就会根据这个方法init()里面所指向的方法handleCommand()并且运行，至于这个方法里面的参数$arg还有$cmd都是pm内部规定的一种参数$cmd就是指指令，当我们输入example时候就会激发这个方法。在handleCommand()方法里面的switch关键字就是个判断语句，最终引发switch里面的console()方法，console()的方法就是在服务端发送信息，break是一个退出循环的关键字如果在switch循环里没有break的话就会一直向下运行其他分支语句。

PHP基本控制语句补充

在PHP语言中八大基本数据类型（四种标量类型：布尔型[boolean]、整型[integer]、浮点型[float/double]、字符串[ string]；两种复合类型：数组[array]、对象[object]；两种特殊类型：资源[resource]、NULL）中有一种叫布尔值的类型，这种是数据类型只有2个值false（整型值0【零】、浮点型值0.0【零】、空白字符串和字符串"0"、没有成员变量的数组、没有单元的对象、特殊类型NULL会被认为是false）还有true（所有其他值都被认为是true【包括任何资源】）

php流程控制语句

条件控制语句和循环控制语句是两种基本的语法结构。它们都是用来控制程序执行流程的，也是构成程序的主要语法基础。

程序的3种控制结构

条件控制语句

循环控制语句

跳转语句

包含语句

1.程序设计的结构大致分为顺序结构，选择(分支)结构和循环结构3种。

循环结构可以按照需要多次重复执行一行或者多行代码，循环结构分为前测试型循环和后测试型循环两种。

前测试型循环，先判断后执行，

后测试型循环，先执行后判断。

条件控制语句：if ,slse,elseif和switch

循环控制语句：while，do...while,for和foreach

跳转控制语句：break，continue和retun

2.条件控制语句

所谓的条件控制语句就是对语句中不同条件的值进行判断，进而根据不同条件执行不同的语句，在条件控制语句中主要有两个语句：if条件控制语句和switch多分支语句。

1. if条件控制语句是所有流程控制语句中最简单，最常用的一个，根据获取的不同条件判断执行不同的语句

if(expr)
statement; //基本的表达式
if(){}
//执行多条件语句的表达式
if(){}else{}
//通过else延伸了表达式
if(){}elseif(){}else{} //这是加入了elseif同时判断多个条件的表达式
//参数expr按照布尔求值，如果为true将执行statement,如果为FALSE,则忽略statement,if语句可以无限层地嵌套到其他if语句中去，实现更多条件的执行。

复制代码

2. switch多分支语句：switch语句和if条件控制语句类似，实现将同一个表达式与很多不同的值比较，获取相同的值，并且执行相同的值对应的语句。

switch(expr){ //表达式的值，即switch语句的条件变量的名称
case expr1;
//放在case语句之后，是要与条件变量expr进行匹配的值中的一个
statement1;
//条件匹配时，执行的代码
break;
//终止语句的执行，即当语句在执行过程中，遇到break主停止执行，跳出循环体
case exp2;
statement2;
break;
default; //case的一个特例，其他任何case都不匹配的情况，并且是最后一条case语句
statementN;
break;
}

复制代码

3、循环语句

循环语句，是在满足条件的情况下反复执行某一个操作，在php中，提供4个循环控制语句，分别是while循环语句，do..while，for，foreach循环

1.while循环语句，其作用是反复地执行某一项操作，是循环控制语句中最简单的一个，也是最常用的一个，while循环语句对表达式的值进行判断，当表达式为非0时，执行while语句中的内嵌语句，当表达式的值为0时，则不执行while语句中的内嵌语句。该语句的特点是：先判断表达式，后执行语句。

例：

while(expr){
statement;
}

复制代码

//只要while表达式的expr的值为TRUE,就重复执行嵌套中的statement语句，如果while表达式的值一开就是FALSE，则循环语句一次也不执行。

while循环语句：

$a=1;
$b=10;
while ($a<=$b){
$p=40*12*$a;
echo
"aaaa:".$a."bbbbb:".$p."<br>";
$a++;
}

复制代码

2、do..while循环语句的使用方式和while相似，也是通过判断表达式的值来输出循环语句。该语句的操作流程是：先执行一次指定的循环语句，然后判断表达式的值，当表达式的值为非0时，返回重新执行循环体语句，如此反复。直到表达式的值等于0为止。特点是，先执行循环体，然后判断循环条件是否成立。

例：

do{
statement;

复制代码

//程序在未经判断之前就先进行一次循环，循环到while部分才判断条件，即使条件不满足，程序也已经运行了一次。

}while(expr);

while和do..while语句之间的区别：do..while语句先执行后判断，无论表达式的值是否为TRUE,都将执行一次循环，而while语句则是首先判断表达式的值是否为TRUE,如果为TRUE则执行循环语句，否则将不执行循环语句。

3、for循环语句，是php中最复杂的循环控制语句，拥有3个条件表达式，语法如下：

for(expr1;expr2;expr3){
statement
}

复制代码

expr1 必要参数，第一个条件表达式，在第一次循环开始时被执行

expr2 必要参数，第二个条件表达式，在每次循环开始时被执行，决定循环是否继续

expr3 必要参数，第三个条件表达式，在每次循环结束时被执行，

statenebt 必要参数，满足条件后，循环执行的语句

其执行过程：首先执行表达式1,然后执行表达式2,并对表达式2的值进行判断，如果值为真，则执行for循环语句中指定的内嵌语句，如果值为假，则结束循环，跳出for循环语句，最后执行表达式3(切忌是在表达式2的值为真时)，返回表达式2继续循环执行，

4、foreach循环语句

foreach循环控制语句自php4开始被引入，主要用于处理数组，是遍历数组的一种简单方法，如果将该语句用于处理其他的数据类型或者初始化的变量，将会产生错误。该语句的语法有两种格式：

foreach(array_expression as $key=>value){
statement
}

复制代码

或

foreach(array_expression as $value){
statement
}

复制代码

array_expression是指定要遍历的数组，其中$key是数组的键名，$value是数组的值，statement是满足条件时要循环执行的语句。

4、跳转语句

跳转语句主要分为break语句，continue语句和return语句3部分，其中前两个跳转语句使用起来非常简单，而且非常容易掌握，主要原因是它们都被应用在指定的环境中，如for循环语句中。return语句在应用环境上较前两者相对单一，一般被使用在自定义函数和面向对象的类中。

break关键字可以终止当前的循环，包括while,do..while,for,foreach和switch在内的所有控制语句，break语句不仅可以跳出当前的循环，还可以指定跳出几重循环，格式如：break n; 参数n指定要跳出的循环数量。

continue跳转语句，在程序执行break后，程序将跳出循环，而开始继续执行循环体的后续语句，continue跳转语句的作用没有break那么强大，只能终止本次循环，而进入到下一次循环中。在执行contiue语句后，程序将结束本次循环的执行，并开始下一轮循环的执行操作。continue也可以指定跳出几重循环。

break和continue语句都是实现跳转的功能，但还有区别，continue语句只是结束本次循环，并不是终止整个循环的执行，而break语句则是结束整个循环过程，不在判断执行循环的条件是否成立。

本资料来自于：http://www.2cto.com/kf/201109/104856.html

类（class）还有函数（也称方法function）都需要用户大括号{}括起来，php里面每个字段（语句）都需要用分号（;）来终结

（这些符合，比如冒号括号之类的需要用的是英文的不能使用中文的因为这两种字符集不一样，php编译器只认英文的符号）。php是松散型语言不像js、JAVA、c等语言php的赋值不需要类型定义的操作符直接使用赋值运算符（=把右边的值赋值给左边的变量），因为php变量的分类是根据你赋值的值自动给予的所以也可以用强制类型转换
允许的强制转换有：

方法（也称函数function）定义方法：

function 方法名(可添加参数){
函数主题句段;
}

复制代码

定义类（class）方法：

class 类名字
{
类句段，类主体由方法还有属性组成
}

复制代码

在pm中这段主体部分

private $api;
public function __construct(ServerAPI $api, $server = false){
$this->api = $api;
}
public function init(){
$this->api->console->register("example", "Example command", array($this, "handleCommand"));
}
public function __destruct(){

复制代码

只有init函数中间的内容是根据插件需要编写其他基本按照这个格式

欢迎加入PocketMine开发&讨论小组

有错误欢迎提

[Pyramid]【PocketMine】插件制作学习&讨论

回复: