Adding JavaPHP v1.0.0 source code

Author: BreadEaterYT

.gitignore

@@ -0,0 +1,38 @@
+target/
+!.mvn/wrapper/maven-wrapper.jar
+!**/src/main/**/target/
+!**/src/test/**/target/
+
+### IntelliJ IDEA ###
+.idea/modules.xml
+.idea/jarRepositories.xml
+.idea/compiler.xml
+.idea/libraries/
+*.iws
+*.iml
+*.ipr
+
+### Eclipse ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+build/
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### VS Code ###
+.vscode/
+
+### Mac OS ###
+.DS_Store

.idea/.gitignore

@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>fr.breadeater</groupId>
+    <artifactId>JavaPHP</artifactId>
+    <version>1.0-SNAPSHOT</version>
+
+    <properties>
+        <maven.compiler.source>21</maven.compiler.source>
+        <maven.compiler.target>21</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    </properties>
+    <dependencies>
+        <dependency>
+            <groupId>org.jetbrains</groupId>
+            <artifactId>annotations</artifactId>
+            <version>26.0.1</version>
+            <scope>compile</scope>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <artifactId>maven-assembly-plugin</artifactId>
+                <configuration>
+                    <archive>
+                        <manifest>
+                            <mainClass>fr.breadeater.Main</mainClass>
+                        </manifest>
+                    </archive>
+                    <descriptorRefs>
+                        <descriptorRef>jar-with-dependencies</descriptorRef>
+                    </descriptorRefs>
+                </configuration>
+                <executions>
+                    <execution>
+                        <id>make-assembly</id>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>single</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>

.idea/encodings.xml

@@ -0,0 +1,26 @@
+package fr.breadeater;
+
+import org.jetbrains.annotations.TestOnly;
+
+import java.io.File;
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * The Main class is used to test the library
+ */
+
+@TestOnly
+public class Main extends PHPJava {
+    public static void main(String[] args) throws Throwable {
+        PHPJava phpjava = new PHPJava(true);
+        Map<String, String> env = new HashMap<>();
+
+        env.put("REQUEST_METHOD", "GET");
+
+        phpjava.setPHPVars(env);
+        phpjava.run(new File("./test.php").getAbsolutePath());
+
+        System.out.println(phpjava.getResult());
+    }
+}

.idea/misc.xml

@@ -0,0 +1,116 @@
+package fr.breadeater;
+
+import java.io.BufferedReader;
+import java.io.InputStreamReader;
+import java.util.Map;
+
+public class PHPJava {
+    private final String PHP_BIN_PATH;
+    private final boolean NO_PHP_WARN;
+
+    private Map<String, String> env_vars;
+    private String response = null;
+
+    /**
+     * Creates a PHPJava instance
+     * @param php_bin_path PHP binary file path (e.g /usr/bin/php)
+     */
+    public PHPJava(String php_bin_path, boolean ignorePHPWarnings){
+        this.PHP_BIN_PATH = php_bin_path;
+        this.NO_PHP_WARN = ignorePHPWarnings;
+    }
+
+    /**
+     * Creates a PHPJava instance
+     * @param ignorePHPWarnings Specifies if PHP Warning and PHP Startup errors should be ignored
+     */
+    public PHPJava(boolean ignorePHPWarnings){
+        this.PHP_BIN_PATH = "php";
+        this.NO_PHP_WARN = ignorePHPWarnings;
+    }
+
+    /**
+     * Creates a PHPJava instance
+     */
+    public PHPJava(){
+        this.PHP_BIN_PATH = "php";
+        this.NO_PHP_WARN = false;
+    }
+
+    /**
+     * Sets PHP global variables like REQUEST_METHOD, REQUEST_ADDR, etc...<br>
+     * See <a href="https://www.php.net/manual/en/reserved.variables.php">PHP global variables</a> for other examples.<br><br>
+     *
+     * WARNING: THIS IS REQUIRED IF USING $_SERVER VARIABLES OR OTHERS !
+     */
+    public void setPHPVars(Map<String, String> variables){
+        this.env_vars = variables;
+    }
+
+    /**
+     * Runs the PHP file specified in the {@link PHPJava} constructor.<br><br>
+     * The result can be retrieved with {@link #getResult()} function.
+     *
+     * @param php_filepath The file path of the PHP file to be executed.
+     */
+    public void run(String php_filepath) throws Throwable {
+        ProcessBuilder processBuilder = new ProcessBuilder(this.PHP_BIN_PATH, "-f", php_filepath);
+        Process process = null;
+
+        if (this.env_vars != null){
+            Map<String, String> environment = processBuilder.environment();
+            environment.putAll(this.env_vars);
+        }
+
+        try {
+            process = processBuilder.start();
+        } catch (Throwable error){
+            String err = error.getMessage();
+
+            if (!this.NO_PHP_WARN && (err.contains("PHP Warning:") || err.contains("PHP Startup:"))){
+                onError(err);
+            }
+        }
+
+        assert process != null;
+        try (BufferedReader reader = new BufferedReader(new InputStreamReader(process.getInputStream()))){
+            StringBuilder resBuilder = new StringBuilder();
+            String line;
+
+            while ((line = reader.readLine()) != null) resBuilder.append(line).append("\n");
+
+            this.response = resBuilder.toString();
+        }
+
+        try (BufferedReader errorReader = new BufferedReader(new InputStreamReader(process.getErrorStream()))){
+            StringBuilder errorBuilder = new StringBuilder();
+            String line;
+
+            while ((line = errorReader.readLine()) != null) errorBuilder.append(line).append("\n");
+
+            if (!errorBuilder.toString().isEmpty()){
+                String err = new Throwable(errorBuilder.toString()).getMessage();
+
+                if (!this.NO_PHP_WARN && (err.contains("PHP Warning:") || err.contains("PHP Startup:"))){
+                    onError(err);
+                }
+            }
+        }
+    }
+
+    /**
+     * Gets the result of the executed PHP file
+     * @return The result of the PHP file, returns null if no results
+     */
+    public String getResult(){
+        return this.response;
+    }
+
+    /**
+     * Error event listener, outputs error with System.err by default, it needs to be overridden
+     * @param error The error
+     */
+    public void onError(String error){
+        System.err.println(error);
+    }
+}