Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/belgattitude/php-java-bridge
Soluble PHP/Java bridge server (unofficial fork)
https://github.com/belgattitude/php-java-bridge
bridge java php php-java-bridge phpjavabridge server soluble-japha
Last synced: 18 days ago
JSON representation
Soluble PHP/Java bridge server (unofficial fork)
- Host: GitHub
- URL: https://github.com/belgattitude/php-java-bridge
- Owner: belgattitude
- License: other
- Created: 2015-11-23T17:15:19.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2021-04-25T10:05:04.000Z (over 3 years ago)
- Last Synced: 2024-11-29T19:55:26.515Z (about 1 month ago)
- Topics: bridge, java, php, php-java-bridge, phpjavabridge, server, soluble-japha
- Language: Java
- Homepage:
- Size: 44.4 MB
- Stars: 47
- Watchers: 5
- Forks: 10
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# PHP Java bridge
[](https://travis-ci.org/belgattitude/php-java-bridge)
[](https://maven-badges.herokuapp.com/maven-central/io.soluble.pjb/php-java-bridge)
[](https://github.com/belgattitude/php-java-bridge/blob/master/LICENSE.md)
(develop branch:
[](https://travis-ci.org/belgattitude/php-java-bridge))
The soluble PHPJavaBridge server fork allows PHP/JVM interoperability through a local network protocol between both runtimes.
> **Disclaimer: Unofficial fork !!!**
>
> This fork was initially made on the [sourceforge](https://sourceforge.net/p/php-java-bridge/code/) version made by Jost Boekemeier
> as its development seemed to have stopped after version 6.2.1.
>
> Be aware that since the project have been forked, the official repo looks to
> be alive again with recent versions supporting PHP7. Unfortunately most of the
> the fixes and enhancements made on this fork have not been merged in upstream version.
>
> Feel free to choose which version you install (fork or official).
> To keep a track of differences, you can refer to the [fork status](./doc/notes_fork_status.md) page.
>
> Note that this fork have been specifically designed for PHP -> Java integration, so
> so if you intend to use it from Java -> PHP, the best is to use the official version as
> it looks better tested for that scenario.
## Installation
This repository can be used to develop, test and and build the JavaBridge server.
Be sure to consult the [soluble-japha](http://docs.soluble.io/soluble-japha/) website
where you'll find more information relative to php/java integration.
## Documentation
- Soluble PHPJavaBridge server [API doc](http://docs.soluble.io/php-java-bridge/api).
- PHP `soluble-japha` client [documentation](https://github.com/belgattitude/soluble-japha)
> Older documentation can be found in the [PHP/Java bridge](http://php-java-bridge.sourceforge.net/pjb/) site
## Releases
- You can download pre-compiled [java bridge binaries](https://github.com/belgattitude/php-java-bridge/releases) on the releases page (jdk8).
- Major releases are published on [Maven central](https://search.maven.org/#search%7Cga%7C1%7Cio.soluble.pjb.php-java-bridge).
With maven:
```
io.soluble.pjb
php-java-bridge
x.y.z
```
or gradle
```
compile 'io.soluble.pjb:php-java-bridge:x.y.z'
```
To register the PHPJavaServlet, you can have a look to the example [web.xml](https://github.com/belgattitude/php-java-bridge/blob/master/src/main/webapp/WEB-INF/web.xml) file.
## Build the project
### Requirements
- Oracle JDK 7,8
- Optionally `ant` for old Java.inc generation
### Get the sources
You can either clone the project with:
```shell
$ git clone https://github.com/belgattitude/php-java-bridge.git
```
or download a zip tarball from the github page.
### Gradle build
Build the project with the provided gradle wrapper:
```shell
$ cd php-java-bridge
$ ./gradlew build
```
The generated files are available in the `/build/libs` folder:
| File | Description |
| ------------- | ------------- |
| `php-java-bridge-.jar` | JavaBridge library (servlet and standalone). |
| `php-java-bridge--sources.jar` | Source code. |
| `php-java-bridge--javadoc.jar` | Generated api doc. |
Additionally a generic template file is automatically generated:
| File | Description |
| -------------| ------------- |
| `JavaBridgeTemplate.war` | A ready to deploy war example file. |
### Adding deps to the builded '.war'
Instead of modifying directly the main `build.gradle` file, you should consider using
init-scripts. Examples can be found on the [init-scripts doc](./init-scripts/README.md).
## Usage
> Currently only tested on Tomcat 7/8, should be running on any servlet 2.5 compatible container.
### Servlet registration
You can have a look to the [web.xml](https://github.com/belgattitude/php-java-bridge/blob/master/src/main/webapp/WEB-INF/web.xml) default configuration
for the servlet configuration settings.
### Deploy
Ensure you have a [Tomcat server](./docs/install/install_tomcat.md) installed.
And copy the ready to run `JavaBridgeTemplate.war` in the tomcat webapps folder:
```shell
$ sudo cp ./build/libs/JavaBridgeTemplate.war /var/lib/tomcat8/webapps/JavaBridgeTemplate.war
```
Wait few seconds for deployment and point your browser to [http://localhost:8080/JavaBridgeTemplate](http://localhost:8080/JavaBridgeTemplate), you should see the
bridge landing page :
Have a look to the error log if needed:
```shell
$ cat /var/log/tomcat8/catalina.out
```
## Develop
For development, the use of the `./gradlew tomcatRun` and `./gradlew tomcatStop` allows testing
without the need of deployment.
Dependencies can be added in the `build.gradle` file.
## FAQ
### OutOfMemory errors under Tomcat
If you get OutOfMemory errors, you can increase the java heap tomcat:
```shell
$ sudo vi /etc/default/tomcat8
```
Look for the Xmx default at 128m and increase
```
JAVA_OPTS="-Djava.awt.headless=true -Xmx512m -XX:+UseConcMarkSweepGC"
```
and restart
```shell
$ sudo service tomcat8 restart
```
## Contribute
Feel free to fork and submit pull requests :)
## Credits
Original developers:
- Jost Boekemeier
- Andre Felipe Machado,
- Sam Ruby,
- Kai Londenberg,
- Nandika Jayawardana,
- Sanka Samaranayake,
Forked version
- [Christian P. Lerch](https://github.com/cplerch): Java refactorings and modernizations.
- [Sébastien Vanvelthem](https://github.com/belgattitude): Fork initiator and maintainer.
See the [CREDITS.md](./CREDITS.md) for an up to date of list of contributors.