shigebeyond / jphp-java-ext

jphp-java-ext -- jphp扩展，用于增强对java对象的操作

1 增强执行php的API

主要的作用是：

1. 简化调用；
2. 开放参数来指定php文件名+变量，自动将java变量转换为php变量；
3. 支持多线程执行，每个线程独有一个jphp引擎；
4. 作为模板引擎的基础。

demo如下：

import net.jkcode.jphp.ext.JphpLauncher

// 执行 index.php 文件，并设置变量$name = "shi"
JphpLauncher.run("index.php" /* php 文件路径 */, mapOf("name" to "shi") /* 包含变量名与变量值的map */)

2 增强对java对象的操作

主要是实现PJavaObject，方便包装java对象，并在php中直接读写属性与调用方法

2.1 java调用端

@Test
fun testJphpLauncher(){
    val lan = JphpLauncher
    val data = mapOf(
            "name" to "shi",
            "maparray" to mapOf("age" to 11, "addr" to "nanning"), // 会转换php的array类型（即java的ArrayMemory）
            // PJavaObject
            "mapjo" to PJavaObject.of(lan.environment, mapOf("goods_id" to 1, "goods_name" to "火龙果", "quantity" to 13)),
            "pojo" to PJavaObject.of(lan.environment, Message("title", "jkcode代码库"))
    )
    lan.run("src/test/resources/index.php", data)
}

2.2 php渲染端

1. 使用 PJavaObject 包含变量

use php\lang\PJavaObject;
// 包装string类型java对象
$strjo = new PJavaObject($name);
// echo $strjo->length()."\n";
// echo $strjo->concat(" is hero")."\n";
echo $strjo->substring(3)."\n"; 

2. 使用 java塞进来的 PJavaObject 对象 2.1 包装hashmap

// 包装hashmap类型java对象
echo 'size: '. $mapjo->size()."\n";
$mapjo->put('price', '11.1');
echo 'size: '. $mapjo->size()."\n";
echo $mapjo->get('goods_name')."\n";
echo $mapjo->get('price')."\n";

2.2 包装pojo

// 包装简单java对象
echo $pojo->getKey()."\n"; // 调用方法
echo $pojo->getMessage()."\n";
$pojo->key = 'title2'; // 写属性，先尝试调用setter方法，然后写属性
echo $pojo->key."\n"; // 读属性, 先尝试调用getter方法，然后读属性

3 支持php文件的重载

包含以下支持

1. 检测文件变化
2. 卸载旧php文件的模块/类/方法等
3. 加载新php文件的模块/类/方法等

4 优化异常处理

1. 修复问题: jphp异常日志中缺失java原始异常信息
2. 截断DieException, 并直接输出其message

5 优化转换器

1. 添加默认的转换器
2. 添加CompletableFuture的转换器
3. 完善HashMap的转换器

6 支持异步处理

1. 实现PCompletableFuture，负责包装 PCompletableFuture
2. JphpLauncher.run() 支持返回 CompletableFuture

7 支持日志

use php\lang\Log;
Log::info("hello {}", ["shi"]);
Log::error("hello shi");

8 支持正则

use php\lang\Reg;
$reg = "\\d(\\w)";
$input = "1a 2a 3b";
var_dump(Reg::find($reg, $input));
var_dump(Reg::findAll($reg, $input));//每个匹配一行
var_dump(Reg::findAllInvert($reg, $input));//每组一行
echo Reg::replace($reg, 'hello', $input);
echo "\n";
var_dump(Reg::split(' ', $input));

9 支持缓存操作

use php\lang\Cache;
$cache = Cache::instance("jedis");
$cache->set("key", "xxxx");
echo $cache->get("key");

10 支持压缩与解压

use php\lang\Zip;
$zipfile = "/ohome/shi/test/test.zip";
Zip::zip("/ohome/shi/test/compare", $zipfile);
Zip::unzip($zipfile, "/ohome/shi/test/compare2");

11 整合到jkguard库

抽象 IMethodMeta 体系, 以便兼容java方法与php方法, 从而将java/php方法调用都纳入 jkguard的守护体系中

详见《jkguard整合jphp-守护php方法》

12 整合到jkmvc框架

1. 支持php写db/orm代码 详见jkmvc整合jphp-db/orm

2. 支持php写controller代码 详见jkmvc整合jphp-controller

13 整合到jksoa框架

支持php调用rpc服务 详见jksoa整合jphp

14 性能最好的模板引擎

14.1 性能对比

针对 velocity / freemarker / jphp 3个模板引擎分别做了性能测试。

1. 测试思路 3个模板引擎对同样逻辑的模板，各自渲染1000次，对比各自耗时。 详见代码TemplateTests.kt

2. 测试结果 3个模板引擎的测试结果如下

执行runJphp()耗时: 8s
执行runVelocity()耗时: 36s
执行runFreemarker()耗时: 14s

=> jphp是性能最好的模板引擎，因为jphp引擎会将php代码编译为等价的java字节码，因此他的执行效率是最高的

14.2 附上3个模板引擎对应的测试模板代码

1. jphp引擎： test.php

<?php
for ($i=0; $i <= 9999; $i++)
{
    echo "Hello $name\n";
    foreach($friends as $f){
        if($i % 2 == 0)
            echo "-$f\n";
        else
            echo "+$f\n";
    }
}

2. velocity引擎： test.vm

#foreach($i in [0..9999])
    Hello $name
    #foreach($f in $friends)
        #if($i % 2 == 0)
            -$f
        #else
            +$f
        #end
    #end
#end

3. freemarker引擎： test.ftl

<#list 0..9999 as i>
    Hello ${name}
    <#list friends as f>
        <#if i % 2 == 0>
            -${f}
        <#else>
            +${f}
        </#if>
    </#list>
</#list>