Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jphp-group/jphp

JPHP - an implementation of PHP on Java VM
https://github.com/jphp-group/jphp

bytecode compiler java java-vm jit jphp jvm php php-language zend-php

Last synced: 2 days ago
JSON representation

JPHP - an implementation of PHP on Java VM

Host: GitHub
URL: https://github.com/jphp-group/jphp
Owner: jphp-group
License: apache-2.0
Created: 2013-10-18T14:52:53.000Z (over 11 years ago)
Default Branch: master
Last Pushed: 2021-12-25T13:33:44.000Z (about 3 years ago)
Last Synced: 2024-10-29T17:47:25.678Z (3 months ago)
Topics: bytecode, compiler, java, java-vm, jit, jphp, jvm, php, php-language, zend-php
Language: Java
Homepage: http://jphp.develnext.org
Size: 11.6 MB
Stars: 1,708
Watchers: 104
Forks: 160
Open Issues: 44
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        JPHP - an implementation of PHP

===============================

[![Build Status](https://travis-ci.org/jphp-group/jphp.svg?branch=master)](https://travis-ci.org/jphp-group/jphp)

JPHP is a new implementation for PHP which uses the Java VM. It supports many features of the PHP language (7.1+).

How does it work? JPHP is a compiler like `javac`, it compiles php sources to JVM bytecode and then

can execute the result on the Java VM.

- Official Site: **[jphp.develnext.org](http://jphp.develnext.org/)**

- [Awesome JPHP](https://github.com/jphp-group/awesome-jphp)

### In Production

We develop a new IDE for beginners like `Game Maker` or `Scirra Construct`. It's based on JPHP, JavaFX, Java 8, Gradle and allows to create desktop games and apps for Linux, Windows and Mac (maybe Android and other platforms in future). The project name is `DevelNext` (https://github.com/jphp-group/develnext-ide), the current status and version of the project is BETA. The project has not yet been localized in English. 

### Goals

JPHP is not a replacement for the Zend PHP engine or Facebook HHVM. We don’t plan to implement the zend runtime libraries (e.g. Curl, PRCE, etc.) for JPHP.

Our project started in October 2013. There were a few reasons for that:

1. Ability to use java libraries in PHP ([own extensions](#own-extensions) + [other](https://github.com/jphp-group/awesome-jphp))

2. Replacing the ugly runtime library of Zend PHP with a better runtime library.

3. Using the PHP language not only on the web

4. Multithreading like in Java and C#.

5. Unicode Strings (Full Support for UTF-8, UTF-16).

6. Creating GUI Android & Desktop applications on PHP language.

### Features

+ PHP 7.1+ (and many language features from PHP 7.2, 7.3, 7.4).

+ JIT (~2.5x faster PHP 5.6, ~1.1x faster PHP 7.0, ~13% slower than PHP 7.4, [bench](#how-to-run-benchmarks)).

+ Using java libraries and classes in PHP code.

+ Unicode for strings (UTF-16, like in Java)

+ [Threading](jphp-runtime/api-docs/classes/php/lang/Thread.md), [Sockets](jphp-runtime/api-docs/classes/php/net/Socket.md), [Environment](jphp-runtime/api-docs/classes/php/lang/Environment.md) architecture (like sandbox objects in the runkit zend extension).

+ GUI ([JavaFX](https://github.com/jphp-group/jphp-gui-ext) or [SWT](https://github.com/jphp-group/jphp-swt-ext))

+ Embedded cache system for classes and functions

+ Optional Hot Reloading for classes and functions

+ Ability to use on **Android** OS : [jphp-android](https://github.com/VenityStudio/jphp-android)

**What JPHP supports from PHP 7.2?**

+ All features except RFC: Parameter Type Widening

**What JPHP supports from PHP 7.3?**

+ All features except RFC: Flexible Heredoc and Nowdoc Syntaxes

**What JPHP supports from PHP 7.4?**

+ Typed Properties 2.0 (partly, references are not supported)

+ Weak References

+ Arrow Functions 2.0 (+ multiple line syntax)

+ Allow throwing exceptions from __toString()

+ Null Coalescing Assignment Operator

+ numeric_literal_separator

+ Spread Operator in Array Expression

### Own Extensions

- [Standard Library](jphp-runtime/api-docs) - own runtime standard library

- [Http Server](exts/jphp-httpserver-ext) (+Web Sockets +Multithread)

- GUI ([JavaFX](https://github.com/jphp-group/jphp-gui-ext) or [SWT](https://github.com/jphp-group/jphp-swt-ext))

- [Git](exts/jphp-git-ext/api-docs) (based on JGit)

- [JSoup](exts/jphp-jsoup-ext/api-docs) - for parsing html in jQuery style.

- [SQL](exts/jphp-sql-ext/api-docs) (supports [MySQL](exts/jphp-sql-ext/api-docs), [PostgreSQL](exts/jphp-pgsql-ext/api-docs), [SQLite](exts/jphp-sqlite-ext/api-docs), [Firebird](exts/jphp-firebirdsql-ext/api-docs)).

- [SSH](exts/jphp-ssh-ext/api-docs) - for working with the ssh protocol.

- [Yaml](exts/jphp-yaml-ext/) - for parsing and formating yaml.

- [Compress](exts/jphp-compress-ext) - for working with tar, gz, bz2, lz4, zip archives.

- [HttpClient](exts/jphp-httpclient-ext/api-docs) - http client with promises.

- [SemVer](exts/jphp-semver-ext/api-docs) - for parsing versions in the SemVer standard.

- [Mail](exts/jphp-mail-ext/api-docs) - for sending emails via SMTP servers.

- [MongoDB](exts/jphp-mongo-ext/api-docs) - a driver for Mongo DB 3.0+.

### Documentation

- You can find the latest api documentation here: [jphp-runtime/api-docs](jphp-runtime/api-docs)

- Wiki here: [read](http://jphp.develnext.org/wiki/)

### Getting started (Hello World)

1. Install jphp package manager (jppm), [how to install](packager/#0-how-to-install-jppm).

2. Init new project (jppm package) with default values:

```bash

jppm init

```

3. Run in console `jppm start`.

You will see `Hello World` in your console, the sources of this program will be in `src/index.php`.

4. (Optional) To update jphp version of your old project:

```bash

jppm update jphp-core

```

### How to run benchmarks?

```

// via jphp

./gradlew bench

// via php

php -f bench/src/bench.php

```

### Build SNAPSHOT from sources

Use `gradle install` to build and install the jphp modules and libraries into the mavel local repository. After this, you can use jphp in your projects as a maven dependency.

`org.develnext.jphp:jphp-:-SNAPSHOT`