CONTRIBUTING.md 4.7 KB

Contribuer

Compiler PHP

Avec Docker (Linux)

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

Sans Docker (Linux et macOS)

Suivez les instructions pour compiler à partir des sources et passez l'indicateur de configuration --debug.

Exécution de la suite de tests

go test -race -v ./...

Module Caddy

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

Serveur de test minimal

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

Construire localement les images Docker

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

Déboguer les erreurs de segmentation dans GitHub Actions

  1. Ouvrir .github/workflows/tests.yml
  2. Activer les symboles de débogage de la bibliothèque PHP

        - uses: shivammathur/setup-php@v2
          # ...
          env:
            phpts: ts
    +       debug: true
    
  3. 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
    
  4. Se connecter au conteneur

  5. Ouvrir frankenphp.go

  6. Activer cgosymbolizer

    - //_ "github.com/ianlancetaylor/cgosymbolizer"
    + _ "github.com/ianlancetaylor/cgosymbolizer"
    
  7. Télécharger le module : go get

  8. Dans le conteneur, vous pouvez utiliser GDB et similaires :

    go test -c -ldflags=-w
    gdb --args ./frankenphp.test -test.run ^MyTest$
    
  9. Quand le bug est corrigé, annulez tous les changements

Ressources Diverses pour le Développement

Ressources Liées à Docker

Commande utile

apk add strace util-linux gdb
strace -e 'trace=!futex,epoll_ctl,epoll_pwait,tgkill,rt_sigreturn' -p 1