Experimental - PHPEngineNK | Cloudburst Nukkit & Minecraft Server Software

Compatible API Versions: 1.0.0 and higher

Sourcecode: https://github.com/Trollhunters501/PHPEngineNK/

Contributors: Creadores Program

PHPEngineNK
Run PHP on Nukkit!
Requirements:
JSEngineNK Plugin: https://cloudburstmc.org/resources/jsenginenk.939/
PHPLib: https://github.com/Trollhunters501/PHPLib
Know Basic JavaScript.
IMPORTANT
Why did I do it in JSEngineNK?
Because in PHP classes and non-object functions are not saved, that means that PHP functions cannot be called and only global objects set by the function (put) or (setNnClassLoader) are maintained. To use PHP you can register a JavaScript function in the manager that then returns PHP code

JavaScript:

manager.createCommand("name", "description", "functionUsed", "usage", ["aliase1", "aliase2"], "perm.nk");
//TestPHP return new PHPEngineNK().build();
function functionUsed(sender, args, label, manageCMD){
  TestPHP.put("sender", sender);
  TestPHP.put("args", args);
  TestPHP.put("label", label);
  TestPHP.put("manageCMD", manageCMD);
  TestPHP.eval("<?php $sender->sendMessage('Hello world!'); ?>");
}

Installation:
First create a script in JSEngineNK as said in your example.
Check if the Library is installed as follows:

JavaScript:

if(!script.getScriptByName("PHPEngineNK")){ //If it is not installed, we install it:
load("https://cdn.jsdelivr.net/gh/Trollhunters501/PHPEngineNK/src/Creadores%20Program/PHPEngineNK.js");
}

DO NOT DOWNLOAD THE FILE FROM HERE I ONLY PUT IT TO LET ME POST THE PLUGIN (use the if above to import the code)

Then create an instance of the Engine:

JavaScript:

var TestPHP = new PHPEngineNK().build();

and then you can run PHP in Nukkit!
Default objects globals:
server and getServer = returns the class cn.nukkit.Server
logger and getLogger = returns the JSEngineNK logger
plugin = returns the JSEngineNK main class
manager = returns the manager class
Examples:
eval:
run PHP with string or reader!

JavaScript:

TestPHP.eval("<?php $getLogger->info('hello world!'); ?>");

put:
establish a global object that returns a java class or function (not compatible with javascript functions!)

JavaScript:

TestPHP.put("exampleName", ExampleJavaClass); //call in php: $exampleName->exampleFunction("hello world!");

getEngineName:
returns the name of the engine (quercus) and the lib

JavaScript:

console.info("engine: " + TestPHP.getEngineName());

setNnClassLoader:
set global objects of classes obtained from the Nnclassloader API

JavaScript:

//first parameter Nnclassloader API code second a json that the variable name is set as global object and the content of the variable is the class obtained from the API
TestPHP.setNnClassLoader({ urls: ["https://testurl.com/test.jar"] }, {
objectName: "class.package.example"
}); //PHP: $objectName->testFunctionInClass("hello world!");

getLanguageVersion:
return PHP version
PHP versión default: 5.3.2
getManager:
return manager engine (quercus)
getEngine:
returns the original engine without the extra functions added by the library (quercus)
getClass:
returns the JS library class
getEngineClass:
returns the original engine class (quercus)
ArrayToCode:
returns PHP code in string separated by lines without needing to put ";" nor the php tag

JavaScript:

TestPHP.eval(TestPHP.ArrayToCode(["$getLogger->info('hello world!')", "$getServer->getLogger()->info('hello world 2!')"]));

printPHPCode:
returns PHP code in string to print a message in the console
Do not use in ArrayToCode

JavaScript:

TestPHP.eval("<?php "+TestPHP.printPHPCode("Hello world!")+" ?>");

ConvertPHP:
returns PHP code in string that converts the arguments into PHP code
Do not use in ArrayToCode

JavaScript:

TestPHP.eval("<?php "+TestPHP.ConvertPHP("object", "functionInObject", ["'args (Remember if you want to pass a string use quotes or you will pass it as an object ($))'", "arg2..."])+" ?>");

evalFile:
run PHP in a PHP file (remember to create the file first)

JavaScript:

TestPHP.evalFile(manager.getFile("TestPHP", "Main.php"));

In plugins/JSEngineNK/TestPHP/Main.php:

PHP:

<?php
$getLogger->info("hello world!");
?>

Call Java classes from PHP:
Call Java classes from PHP similar to JSEngineNK's Java.type

PHP:

$test = java_class("cn.nukkit.Server");
//Or
import cn.nukkit.Server;
//With import you can extend it with php classes

Same as Java.type!

If you want to make plugins for your server, do not hesitate to Contact Us!
Discord: https://discord.gg/mrmHcwxXff
WhatsApp channel: https://whatsapp.com/channel/0029Va5bITcGZNCqyYkDYZ0F

Experimental PHPEngineNK 1.2

More resources from Trollhunters501

Share this resource

Latest updates

JSdelivr Update

Solution to the error on line 83

Incorrect description update