Konwertuj PHP na PDF

Kopia o stałym układzie jest potrzebna, gdy strona wygenerowana przez PHP musi zostać wydrukowana, przesłana, udostępniona lub zarchiwizowana. Sam kod źródłowy PHP musi zostać wykonany w celu wygenerowania strony albo sformatowany jako kod; zwykły konwerter plików nie renderuje go bezpośrednio do gotowego pliku PDF.

Czym jest format PHP

PHP to język skryptowy po stronie serwera używany przez twórców stron internetowych i administratorów do generowania dynamicznych stron, formularzy, faktur, raportów i odpowiedzi API. Plik .php zawiera kod źródłowy, zwykle połączony z HTML, CSS, SQL lub znacznikami szablonu; PHP jest językiem programowania, a nie formatem dokumentu.

Serwer internetowy obsługujący PHP interpretuje plik i zwraca wygenerowany wynik, zwykle HTML, do przeglądarki. Otwarcie pliku .php z poziomu menedżera plików nie uruchamia jego kodu po stronie serwera: w zależności od systemu operacyjnego i aplikacji może wyświetlić tekst źródłowy albo zakończyć się niepowodzeniem.

Czym jest format PDF

PDF to format dokumentu o stałym układzie, który zachowuje wymiary stron, czcionki, obrazy, odstępy i podział na strony w różnych systemach operacyjnych i na różnych urządzeniach. Odbiorcy mogą go drukować lub wyświetlać bez PHP, serwera internetowego ani aplikacji, w której utworzono oryginalną stronę.

PDF nadaje się do faktur, oficjalnych zgłoszeń, załączników wiadomości e-mail i kopii archiwalnych. Zwykle nie jest przeznaczony do edycji tak jak plik edytora tekstu, a konwersja nie gwarantuje mniejszego rozmiaru pliku; osadzone czcionki i obrazy mogą go zwiększyć.

Konwertowanie wygenerowanej strony PHP

Użyj tej metody, gdy wymagany plik PDF jest raportem, potwierdzeniem, formularzem lub inną stroną wygenerowaną przez skrypt.

1. Zainstaluj PHP oraz, jeśli jest wymagany, lokalny pakiet serwera, taki jak XAMPP, Laragon lub MAMP. Wbudowany serwer PHP wystarcza w przypadku wielu samodzielnych projektów.
2. Umieść projekt w jego katalogu dokumentów i skonfiguruj wymagane bazy danych, zmienne środowiskowe, rozszerzenia, dołączane pliki oraz foldery z uprawnieniami do zapisu.
3. Z odpowiedniego katalogu projektu lub katalogu głównego dokumentów uruchom php -S localhost:8000. Polecenie uruchamia serwer deweloperski; nie jest to wdrożenie produkcyjne.
4. Otwórz odpowiedni adres, taki jak http://localhost:8000/report.php, w Chrome, Edge lub Firefox i sprawdź, czy strona zawiera oczekiwane dane.
5. Użyj opcji Print → Save as PDF w przeglądarce. Wybierz wymagany rozmiar papieru i marginesy, włącz grafiki tła, jeśli projekt ich używa, oraz sprawdź podziały stron, obrazy, nagłówki i stopki w podglądzie wydruku.

W przypadku powtarzalnych danych wyjściowych generowanych po stronie serwera użyj przepływu pracy z bezgłowym Chromium, korzystając z Playwright lub Puppeteer i ich funkcji PDF. Zastosuj ten sam CSS wydruku, obszar widoku, format papieru, marginesy i warunki ładowania strony, które są używane w środowisku produkcyjnym; przed wygenerowaniem pliku PDF zaczekaj na żądania sieciowe i treść renderowaną przez JavaScript.

Jeśli strona jest już dostępna jako HTML, renomowane usługi online, takie jak PDFCrowd lub CloudConvert, mogą przeprowadzić konwersję HTML do PDF. Prześlij wygenerowany HTML, a nie oryginalny plik .php: usługi te zasadniczo nie wykonują dowolnego kodu PHP, a zewnętrzne arkusze stylów, czcionki, obrazy, sesje i uwierzytelnione dane mogą być dla nich niedostępne.

Konwertowanie kodu źródłowego PHP

Użyj tej metody, gdy sam kod źródłowy jest dokumentem, na przykład na potrzeby przeglądu kodu, materiałów szkoleniowych lub dokumentacji papierowej.

1. Otwórz plik w edytorze kodu, takim jak PhpStorm, Notepad++ lub Visual Studio Code, i włącz podświetlanie składni PHP.
2. Ustaw czytelną czcionkę o stałej szerokości, odpowiednie marginesy, zawijanie wierszy oraz opcjonalne numery wierszy. Wyłącz zawijanie, jeśli zachowanie dokładnych wierszy kodu jest ważniejsze niż dopasowanie kodu do strony.
3. Drukuj z edytora obsługującego drukowanie, takiego jak Notepad++ lub PhpStorm, i wybierz systemową drukarkę PDF: Microsoft Print to PDF w systemie Windows lub Save as PDF w oknie dialogowym drukowania systemu macOS. Visual Studio Code może wymagać rozszerzenia do drukowania lub pośredniego eksportu do HTML.

W przypadku automatycznego tworzenia plików PDF z kodem źródłowym zastosuj podświetlanie składni za pomocą Pygments lub podobnego formatera, wyeksportuj wynik jako HTML i wydrukuj ten HTML za pośrednictwem Chromium. Dokumentuje to tekst źródłowy; nie wykonuje PHP ani nie przechwytuje strony wygenerowanej przez skrypt.

Generowanie plików PDF wewnątrz aplikacji PHP

W przypadku cyklicznych faktur, raportów lub formularzy aplikacja PHP może tworzyć pliki PDF z szablonów za pomocą bibliotek takich jak Dompdf, mPDF lub TCPDF. Jest to generowanie plików PDF, a nie konwersja plików, i wymaga kodu, instalacji zależności, przygotowania szablonów oraz przetestowania obsługi CSS.

Ograniczenia dotyczące jakości i bezpieczeństwa

Uwierzytelnianie, wyniki zapytań do bazy danych, brakujące rozszerzenia PHP, uprawnienia, ścieżki względne, zewnętrzny CSS, czcionki internetowe, JavaScript oraz CSS wydruku przeglądarki mogą zmienić renderowany wynik. Przetestuj rozwiązanie z reprezentatywnymi danymi, sprawdź obrazy i podziały stron oraz porównaj plik PDF ze stroną pod zamierzonym adresem URL.

Nie przesyłaj poufnego kodu źródłowego PHP, danych uwierzytelniających, danych klientów ani prywatnych wygenerowanych stron do konwertera online. Lokalna przeglądarka, proces bezgłowego Chromium lub biblioteka PDF dla PHP zapobiegają ujawnieniu tych plików i umożliwiają dostęp do lokalnych zależności. Usuń sekrety z plików PDF zawierających kod źródłowy i sprawdź, czy wygenerowane pliki PDF nie zawierają niezamierzonych metadanych ani ukrytych danych formularzy.