Questa pagina è stata tradotta dalla community e potrebbe non essere aggiornata. Consulta la versione di riferimento (in inglese).
Questa pagina è stata tradotta dalla community e potrebbe non essere aggiornata. Consulta la versione di riferimento (in inglese).
Questa pagina è stata tradotta dalla community e potrebbe non essere aggiornata. Consulta la versione di riferimento (in inglese).
Per una panoramica dell’architettura di FrankenPHP (tipi di thread, macchina a stati, confine CGO, flusso di richiesta), consultare la documentazione interna.
Costruire l’immagine Docker di sviluppo:
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’immagine contiene i consueti strumenti di sviluppo (Go, GDB, Valgrind, Neovim…) e utilizza le seguenti posizioni di impostazione php
/etc/frankenphp/php.ini Per impostazione predefinita viene fornito un file php.ini con preimpostazioni di sviluppo./etc/frankenphp/php.d/*.ini/usr/lib/frankenphp/modules/Se la versione di Docker è precedente alla 23.0, la compilazione avrà esito negativo a causa di dockerignore problema relativo al modello. Aggiungere a .dockerignore:
!testdata/*.php
!testdata/*.txt
+!caddy
+!internal
Seguire le istruzioni per compilare dai sorgenti e passare il flag di configurazione --debug.
export CGO_CFLAGS=-O0 -g $(php-config --includes) CGO_LDFLAGS="$(php-config --ldflags) $(php-config --libs)"
go test -race -v ./...
Costruire Caddy con il modulo FrankenPHP Caddy:
cd caddy/frankenphp/
go build -tags nobadger,nomysql,nopgx
cd ../../
Eseguire Caddy con il modulo FrankenPHP Caddy:
cd testdata/
../caddy/frankenphp/frankenphp run
Il server è in ascolto su 127.0.0.1:80:
Note
Se utilizzi Docker, dovrai associare la porta 80 del container o eseguire l’esecuzione dall’interno del container
curl -vk http://127.0.0.1/phpinfo.php
Costruire il server di test minimo:
cd internal/testserver/
go build
cd ../../
Eseguire il server di test:
cd testdata/
../internal/testserver/testserver
Il server è in ascolto su 127.0.0.1:8080:
curl -v http://127.0.0.1:8080/phpinfo.php
Configurare Git per utilizzare sempre le terminazioni di riga lf
git config --global core.autocrlf false
git config --global core.eol lf
Installare Visual Studio, Git e Go:
winget install -e --id Microsoft.VisualStudio.2022.Community --override "--passive --wait --add Microsoft.VisualStudio.Workload.NativeDesktop --add Microsoft.VisualStudio.Component.VC.Llvm.Clang --includeRecommended"
winget install -e --id GoLang.Go
winget install -e --id Git.Git
Installare vcpkg:
cd C:\
git clone https://github.com/microsoft/vcpkg
.\vcpkg\bootstrap-vcpkg.bat
Scaricare l’ultima versione della libreria watcher per Windows ed estraila in una cartella denominata C:\watcher
Scaricare l’ultima versione Thread Safe di PHP e di PHP SDK per Windows, estraili nelle cartelle denominate C:\php e C:\php-devel
Clonare il repository Git di FrankenPHP:
git clone https://github.com/php/frankenphp C:\frankenphp
cd C:\frankenphp
Installare le dipendenze:
C:\vcpkg\vcpkg.exe install
Configurare le variabili di ambiente necessarie (PowerShell):
$env:PATH += ';C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\Llvm\bin'
$env:CC = 'clang'
$env:CXX = 'clang++'
$env:CGO_CFLAGS = "-O0 -g -IC:\frankenphp\vcpkg_installed\x64-windows\include -IC:\watcher -IC:\php-devel\include -IC:\php-devel\include\main -IC:\php-devel\include\TSRM -IC:\php-devel\include\Zend -IC:\php-devel\include\ext"
$env:CGO_LDFLAGS = '-LC:\frankenphp\vcpkg_installed\x64-windows\lib -lbrotlienc -LC:\watcher -llibwatcher-c -LC:\php -LC:\php-devel\lib -lphp8ts -lphp8embed'
Eseguire i test:
go test -race -ldflags '-extldflags="-fuse-ld=lld"' ./...
cd caddy
go test -race -ldflags '-extldflags="-fuse-ld=lld"' -tags nobadger,nomysql,nopgx ./...
cd ..
Costruire il binario:
cd caddy/frankenphp
go build -ldflags '-extldflags="-fuse-ld=lld"' -tags nobadger,nomysql,nopgx
cd ../..
Stampare il piano di compilazione:
docker buildx bake -f docker-bake.hcl --print
Creare immagini FrankenPHP per amd64 localmente:
docker buildx bake -f docker-bake.hcl --pull --load --set "*.platform=linux/amd64"
Creare immagini FrankenPHP per arm64 localmente:
docker buildx bake -f docker-bake.hcl --pull --load --set "*.platform=linux/arm64"
Creare immagini FrankenPHP da zero per arm64 e amd64 e inviale a Docker Hub:
docker buildx bake -f docker-bake.hcl --pull --no-cache --push
Scaricare la versione di debug del binario FrankenPHP da GitHub o creare la propria build statica personalizzata includendo i simboli di debug:
docker buildx bake \
--load \
--set static-builder.args.DEBUG_SYMBOLS=1 \
--set "static-builder.platform=linux/amd64" \
static-builder
docker cp $(docker create --name static-builder-musl dunglas/frankenphp:static-builder-musl):/go/src/app/dist/frankenphp-linux-$(uname -m) frankenphp
Sostituire la versione corrente di frankenphp con l’eseguibile di debug FrankenPHP
Avviare FrankenPHP come al solito (in alternativa si può avviare direttamente FrankenPHP con GDB: gdb --args frankenphp run)
Accedere al processo con GDB:
gdb -p `pidof frankenphp`
Se necessario, digitare continue nella shell GDB
Mandare in crash FrankenPHP
Digitarere bt nella shell GDB
Copiare l’output
Aprire .github/workflows/tests.yml
Abilitare i simboli di debug PHP
- uses: shivammathur/setup-php@v2
# ...
env:
phpts: ts
+ debug: true
Abilitare tmate per connettersi al contenitore
- name: Set CGO flags
run: echo "CGO_CFLAGS=-O0 -g $(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
Connettersi al contenitore
Aprire frankenphp.go
Abilitare cgosymbolizer
- //_ "github.com/ianlancetaylor/cgosymbolizer"
+ _ "github.com/ianlancetaylor/cgosymbolizer"
Scaricare il modulo: go get
Nel contenitore è possibile utilizzare GDB e simili:
go test -tags -c -ldflags=-w
gdb --args frankenphp.test -test.run ^MyTest$
Una volta risolto il bug, annullare tutte le modifiche fatte
Seguire le istruzioni in compilazione dai sorgenti. I passaggi presuppongono il seguente ambiente:
/usr/local/go~/php-src/usr/local/bin/php~/frankenphpInstallare CLion (sul sistema operativo host)
Scaricare da JetBrains
Avviare (se su Windows, in WSL):
clion &>/dev/null
Aprire il progetto in CLion
~/frankenphpBuild impostare uno strumento esterno (chiamalo ad esempio go build)go_compile_frankenphp.shCGO_CFLAGS="-O0 -g" ./go.sh
go_compile_frankenphp.sh~/frankenphp/caddy/frankenphpConfigurare le destinazioni della corsa
go build creato in precedenza~/frankenphp/caddy/frankenphp/frankenphpphp-cli test.phpEseguire il debug dei file Go da CLion
Ora si possono inserire breakpoint nei file C, C++ e Go.
Per ottenere l’evidenziazione della sintassi per le importazioni da php-src, potrebbe essere necessario comunicare a CLion i percorsi di inclusione. Creare un
File compile_flags.txt in ~/frankenphp con il seguente contenuto:
-I/usr/local/include/php
-I/usr/local/include/php/Zend
-I/usr/local/include/php/main
-I/usr/local/include/php/TSRM
Utilizzare GoLand per lo sviluppo Go primario, ma il debugger non può eseguire il debug del codice C.
Installare GoLand (sul sistema operativo host)
Scaricare da JetBrains
goland &>/dev/null
Aprire in GoLand
~/frankenphpfrankenphp~/frankenphp/caddy/frankenphp~/frankenphp/caddy/frankenphp~/frankenphp/caddy/frankenphpCGO_CFLAGS=-O0 -g -I/usr/local/include/php -I/usr/local/include/php/main -I/usr/local/include/php/TSRM -I/usr/local/include/php/Zend -I/usr/local/include/php/ext -I/usr/local/include/php/ext/date/lib;CGO_LDFLAGS=-lm -lpthread -lsqlite3 -lxml2 -lbrotlienc -lbrotlidec -lbrotlicommon -lwatcher-tags=nobadger,nomysql,nopgxphp-cli -iPer eseguire il debug dei file C da GoLand
Ora si possono inserire breakpoint nei file C, C++ e Go.
Seguire la sezione Sviluppo Windows
Installare GoLand
Aprire in GoLand
frankenphp è stato clonatoConfigurare Go Build
frankenphp.\caddy\frankenphp.\caddy\frankenphp.\caddy\frankenphp-tags=nobadger,nomysql,nopgxphp-servercgo di collegamentoapk add strace util-linux gdb
strace -e 'trace=!futex,epoll_ctl,epoll_pwait,tgkill,rt_sigreturn' -p 1
Per tradurre la documentazione e il sito in una nuova lingua, seguire questi passaggi:
docs/ di questo repository.md nella radice della cartella docs/ nella nuova cartella (utilizzare sempre la versione inglese come fonte per la traduzione, poiché è sempre aggiornata)README.md e CONTRIBUTING.md dalla cartella principale alla nuova cartella> [! (è un markup speciale per GitHub)content/, data/ e i18n/