Construisez l'image Docker de développement :
docker build -t frankenphp-dev -f dev.Dockerfile .
docker run --cap-add=SYS_PTRACE --security-opt seccomp=unconfined -p 8080:8080 -p 443:443 -p 443:443/udp -v $PWD:/go/src/app -it frankenphp-dev
L'image contient les outils de développement habituels (Go, GDB, Valgrind, Neovim...).
Si la version de Docker est inférieure à 23.0, la construction échoue à cause d'un problème de pattern dans .dockerignore
. Ajoutez les répertoires à .dockerignore
.
!testdata/*.php
!testdata/*.txt
+!caddy
+!C-Thread-Pool
+!internal
Suivez les instructions pour compiler à partir des sources et passez l'indicateur de configuration --debug
.
go test -race -v ./...
Construire Caddy avec le module FrankenPHP :
cd caddy/frankenphp/
go build
cd ../../
Exécuter Caddy avec le module FrankenPHP :
cd testdata/
../caddy/frankenphp/frankenphp run
Le serveur est configuré pour écouter à l'adresse 127.0.0.1:8080
:
curl -vk https://localhost/phpinfo.php
Construire le serveur de test minimal :
cd internal/testserver/
go build
cd ../../
Lancer le test serveur :
cd testdata/
../internal/testserver/testserver
Le serveur est configuré pour écouter à l'adresse 127.0.0.1:8080
:
curl -v http://127.0.0.1:8080/phpinfo.php
Afficher le plan de compilation :
docker buildx bake -f docker-bake.hcl --print
Construire localement les images FrankenPHP pour amd64 :
docker buildx bake -f docker-bake.hcl --pull --load --set "*.platform=linux/amd64"
Construire localement les images FrankenPHP pour arm64 :
docker buildx bake -f docker-bake.hcl --pull --load --set "*.platform=linux/arm64"
Construire à partir de zéro les images FrankenPHP pour arm64 & amd64 et les pousser sur Docker Hub :
docker buildx bake -f docker-bake.hcl --pull --no-cache --push
.github/workflows/tests.yml
Activer les symboles de débogage de la bibliothèque PHP
- uses: shivammathur/setup-php@v2
# ...
env:
phpts: ts
+ debug: true
Activer tmate
pour se connecter au conteneur
-
name: Set CGO flags
run: echo "CGO_CFLAGS=$(php-config --includes)" >> "$GITHUB_ENV"
+ -
+ run: |
+ sudo apt install gdb
+ mkdir -p /home/runner/.config/gdb/
+ printf "set auto-load safe-path /\nhandle SIG34 nostop noprint pass" > /home/runner/.config/gdb/gdbinit
+ -
+ uses: mxschmitt/action-tmate@v3
Se connecter au conteneur
Ouvrir frankenphp.go
Activer cgosymbolizer
- //_ "github.com/ianlancetaylor/cgosymbolizer"
+ _ "github.com/ianlancetaylor/cgosymbolizer"
Télécharger le module : go get
Dans le conteneur, vous pouvez utiliser GDB et similaires :
go test -c -ldflags=-w
gdb --args ./frankenphp.test -test.run ^MyTest$
Quand le bug est corrigé, annulez tous les changements
apk add strace util-linux gdb
strace -e 'trace=!futex,epoll_ctl,epoll_pwait,tgkill,rt_sigreturn' -p 1