This package implements support for executing PHP scripts, exporting Go variables for use in PHP contexts, attaching Go method receivers as PHP classes and returning PHP variables for use in Go contexts.
Both PHP 5.x and PHP 7.x series are supported.
Building this package requires that you have PHP installed as a library. For most Linux systems, this can usually be found in the php-embed package, or variations thereof.
Once the PHP library is available, the bindings can be compiled with go build and are go get-able.
Note: Building against PHP 5.x requires that the php5 tag is provided, i.e.:
go get -tags php5 github.com/deuill/go-phpThis is due to the fact that PHP 7.x is the default build target.
Executing PHP script files as well as inline strings is supported and stable.
Binding Go values as PHP variables is allowed for most base types, and PHP values returned from eval'd strings can be converted and used in Go contexts as interface{} values.
It is possible to attach Go method receivers as PHP classes, with full support for calling expored methods, as well as getting and setting embedded fields (for struct-type method receivers).
Be aware that, by default, PHP is not designed to be used in multithreaded environments (which severely restricts the use of these bindings with Goroutines) if not built with ZTS support. However, ZTS support has seen major refactoring between PHP 5 and PHP 7, and as such is currently unsupported by this package.
Currently, it is recommended to either sync use of seperate Contexts between Goroutines, or share a single Context among all running Goroutines.
Currently, the package lacks in several respects:
- ZTS/multi-threading support. This basically means using Go-PHP in Goroutines is severely limited.
- Documentation and examples, both package-level and external.
- Performance. There's no reason to believe Go-PHP suffers from any serious performance issues in particular, but adding benchmarks, especially compared against vanilla PHP, might help.
- Your feature request here?
These items will be tackled in order of significance (which may not be the order shown above).
Executing a script is simple:
package main
import (
php "github.com/deuill/go-php"
"os"
)
func main() {
engine, _ := php.New()
context, _ := engine.NewContext()
context.Output = os.Stdout
context.Exec("index.php")
engine.Destroy()
}The above will execute script file index.php located in the current folder and will write any output to the io.Writer assigned to Context.Output (in this case, the standard output).
The following example demonstrates binding a Go variable to the running PHP context, and returning a PHP variable for use in Go:
package main
import (
"fmt"
php "github.com/deuill/go-php"
)
func main() {
engine, _ := php.New()
context, _ := engine.NewContext()
var str string = "Hello"
context.Bind("var", str)
val, _ := context.Eval("return $var.' World';")
fmt.Printf("%s", val.Interface())
// Prints 'Hello World' back to the user.
engine.Destroy()
}A string value "Hello" is attached using Context.Bind under a name var (available in PHP as $var). A script is executed inline using Context.Eval, combinding the attached value with a PHP string and returning it to the user.
Finally, the value is returned as an interface{} using Value.Interface() (one could also use Value.String(), though the both are equivalent in this case).
All code in this repository is covered by the terms of the MIT License, the full text of which can be found in the LICENSE file.
// TODO: Figure out which package are really needed. but it works when all of them are there // TODO: Check if all of this still works out after all the changes!!!
Just use docker to build your application or the subsystem, because i have no idea how to get php-embed on windows without building the complete php source which kinda sucks. If there is a Windows version of php-embed, you should be able to use it but you also need g++ etc. to build the go-php package.
If there is a Windows Developer out there who knows how to solve it, just push an edit here or add an issue with explanations, and i will try to help with the write down. Thanks!
Your steps should be similar to the Linux version. You probably need to adapt the tags/etc. to your system but its untested because i dont have access to an up2date osx system. So to make it easyer just use Docker.
We need to use ppa:ondrej/php for older PHP-Versions which im using for years and never had problems, but rules for ppa´s apply! So if you wand to be extra safe build in a container or vm!
sudo apt-add-repository ppa:ondrej/php
sudo apt-get update
sudo apt-get install php5.6-embed
sudo apt-get install libphp5.6-embed
sudo apt-get install php5.6-devsudo apt-add-repository ppa:ondrej/php
sudo apt-get update
sudo apt-get install php7.0-embed
sudo apt-get install libphp7.0-embed
sudo apt-get install php7.0-devsudo apt-add-repository ppa:ondrej/php
sudo apt-get update
sudo apt-get install libphp7.4-embed
sudo apt-get install php7.4-devsudo apt-add-repository ppa:ondrej/php
sudo apt-get update
sudo apt-get install libphp8.0-embed
sudo apt-get install php8.0-dev-
php5
-
php7
-
php7.4
-
php8
-
debian
-
static // TODO: Check if this works?
go get github.com/tuefekci/go-php -tags='debian php7'// TODO: There is already a Docker file from deuill it probably needs to be updated to the latest version.
go build -tags='debian php7' your-main.go