2021-09-24 16:52:20 +00:00
|
|
|
# Contributing
|
|
|
|
|
|
2022-10-04 12:36:03 +00:00
|
|
|
## Running the test suite
|
2021-09-24 16:52:20 +00:00
|
|
|
|
2022-10-04 12:36:03 +00:00
|
|
|
go test -race -v ./...
|
|
|
|
|
|
|
|
|
|
## Testing in live
|
|
|
|
|
### With Docker (Linux)
|
|
|
|
|
|
|
|
|
|
Prepare a dev Docker image:
|
|
|
|
|
|
|
|
|
|
docker build -t frankenphp .
|
|
|
|
|
docker run -p 8080:8080 -p 443:443 -v $PWD:/go/src/app -it frankenphp bash
|
|
|
|
|
|
|
|
|
|
#### Caddy module
|
|
|
|
|
|
|
|
|
|
Build Caddy with the FrankenPHP Caddy module:
|
|
|
|
|
|
|
|
|
|
cd /go/src/app/caddy/frankenphp/
|
|
|
|
|
go build
|
|
|
|
|
|
|
|
|
|
Run the Caddy with the FrankenPHP Caddy module:
|
|
|
|
|
|
|
|
|
|
cd /go/src/app/testdata/
|
|
|
|
|
../caddy/frankenphp/frankenphp run
|
|
|
|
|
|
|
|
|
|
#### Minimal test server
|
|
|
|
|
|
|
|
|
|
Build the minimal test server:
|
|
|
|
|
|
|
|
|
|
cd /go/src/app/internal/testserver/
|
|
|
|
|
go build
|
|
|
|
|
|
|
|
|
|
Run the test server:
|
|
|
|
|
|
|
|
|
|
cd /go/src/app/testdata/
|
|
|
|
|
../internal/testserver/testserver
|
|
|
|
|
|
|
|
|
|
The server is listening on `127.0.0.1:8080`:
|
|
|
|
|
|
|
|
|
|
curl http://127.0.0.1:8080/phpinfo.php
|
|
|
|
|
|
|
|
|
|
### Without Docker (Linux and macOS)
|
|
|
|
|
|
|
|
|
|
Compile PHP:
|
|
|
|
|
|
|
|
|
|
./configure --enable-debug --enable-zts
|
|
|
|
|
make -j6
|
|
|
|
|
sudo make install
|
|
|
|
|
|
|
|
|
|
Build the minimal test server:
|
|
|
|
|
|
|
|
|
|
cd internal/testserver/
|
|
|
|
|
go build
|
|
|
|
|
|
|
|
|
|
Run the test app:
|
|
|
|
|
|
|
|
|
|
cd ../../testdata/
|
|
|
|
|
../internal/testserver/testserver
|
