PHPackages elamacchia/gespidieffe - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [PDF & Document Generation](/categories/documents) 4. / 5. elamacchia/gespidieffe ActiveLibrary[PDF & Document Generation](/categories/documents) elamacchia/gespidieffe ====================== Gestione e modifica file PDF (censura, unione, divisione, rotazione, conteggio pagine) 00Blade Since Mar 26Pushed 2mo agoCompare [ Source](https://github.com/EnzoLamacchia/GesPidieffe)[ Packagist](https://packagist.org/packages/elamacchia/gespidieffe)[ RSS](/packages/elamacchia-gespidieffe/feed)WikiDiscussions main Synced 3w ago READMEChangelogDependenciesVersions (1)Used By (0) GespidiEffe — Gestione e modifica file PDF ========================================== [](#gespidieffe--gestione-e-modifica-file-pdf) [![Framework](https://camo.githubusercontent.com/1cc1837b2f37df2a870b75661db08ca3cbb7a63d8f3401e42d7298c123898ea3/68747470733a2f2f696d672e736869656c64732e696f2f7374617469632f76313f6c6162656c3d4672616d65776f726b266d6573736167653d4c61726176656c253230392e7826636f6c6f723d726564267374796c653d666f722d7468652d6261646765266c6f676f3d6c61726176656c)](https://laravel.com)[![PHP Version](https://camo.githubusercontent.com/da4207a727b5639bf64ed32a1aa90a527bf7d74d7bc3fbce1cb93eb70e266690/68747470733a2f2f696d672e736869656c64732e696f2f7374617469632f76313f6c6162656c3d50485025323056657273696f6e266d6573736167653d382e3126636f6c6f723d373737424234267374796c653d666f722d7468652d6261646765266c6f676f3d706870)](https://php.net)[![License](https://camo.githubusercontent.com/58839975da5e71ac5361806c6306e05d68621aef7fbf0e34f07909d29a4d247c/68747470733a2f2f696d672e736869656c64732e696f2f7374617469632f76313f6c6162656c3d4c6963656e7365266d6573736167653d4d495426636f6c6f723d677265656e267374796c653d666f722d7468652d6261646765)](https://opensource.org/licenses/MIT) GesPidieffe è un package Laravel per la gestione e la modifica di file PDF direttamente dal browser. Fa parte dell'ecosistema **AdmEL** ed è progettato per essere integrato come package locale in un'applicazione Laravel 9. --- Funzionalità ------------ [](#funzionalità) FunzioneDescrizione**Censura PDF**Disegna rettangoli neri su aree sensibili del documento; supporto ibrido vettoriale/raster**Unione PDF (Merge)**Carica più file PDF, riordinali con drag & drop, uniscili in un unico documento**Divisione PDF (Split)**Estrae singole pagine o intervalli; download del singolo PDF o di uno ZIP con tutti i file estratti**Organizza pagine**Griglia drag & drop per riordinare, duplicare o eliminare singole pagine**Ruota pagine**Ruota singole pagine o l'intero documento a passi di 90°; badge visivo con i gradi correnti**Numerazione pagine**Aggiunge numeri di pagina con posizione, font, dimensione e colore personalizzabili; testo originale rimane selezionabile**Unisci e Organizza**Workflow a 3 passi: carica più PDF → riordina i file con drag & drop → unisce automaticamente → editor pagine per riordinare/duplicare/eliminare → download PDF finale**Statistiche utilizzo**Dashboard con contatori giornalieri, settimanali e globali per ciascuna funzione; storico delle ultime 12 settimane; accessibile solo agli utenti con permesso `usa gespidieffe`**PDF to Word**Converte un PDF in documento Word (.docx) editabile. Rileva automaticamente il tipo di PDF (nativo/ibrido/scansionato) e applica la strategia di conversione ottimale.--- Requisiti --------- [](#requisiti) ### Applicazione host [](#applicazione-host) RequisitoVersionePHP^8.0Laravel9.xLaravel Jetstream^2.14Laravel Sanctum^3.0### Dipendenze PHP (Composer) [](#dipendenze-php-composer) PackageVersione`setasign/fpdi`^2.3`tecnickcom/tcpdf`^6.5### Dipendenze di sistema (nel container Docker) [](#dipendenze-di-sistema-nel-container-docker) I seguenti strumenti devono essere presenti nel container PHP: StrumentoUtilizzo`qpdf`Merge, split, rotazione, conteggio pagine, estrazione JSON`ghostscript` (`gs`)Rasterizzazione pagine PDF in PNG (censura raster; OCR su PDF scansionati)`pdftk`Applicazione overlay di numerazione pagine (`multistamp`)`libreoffice` + `libreoffice-writer`Conversione `.txt` → `.docx` (PDF ibridi e scansionati)`tesseract-ocr` + `tesseract-ocr-ita`OCR su pagine rasterizzate (PDF scansionati)`poppler-utils``pdftotext`, `pdfimages`, `pdfinfo` — estrazione testo, analisi immagini, dimensioni pagina`pandoc`Conversione `.txt` → `.docx` strutturato (PDF ibridi e scansionati)`python3` + `pdf2docx`Conversione PDF nativo → `.docx` con layout, tabelle e immagini preservatiNel Dockerfile (Laravel Sail, runtime PHP 8.1) i pacchetti di sistema vengono installati con: ``` apt-get install -y ghostscript qpdf pdftk libreoffice libreoffice-writer tesseract-ocr tesseract-ocr-ita poppler-utils ``` `pandoc` non è nei repo Ubuntu 22.04 — va installato dal pacchetto `.deb` ufficiale: ``` curl -sLO https://github.com/jgm/pandoc/releases/download/3.1.13/pandoc-3.1.13-1-amd64.deb dpkg -i pandoc-3.1.13-1-amd64.deb ``` `pdf2docx` va installato con pip: ``` pip install pdf2docx ``` > **Server standalone (Linux/AlmaLinux):** usare un virtualenv dedicato per pdf2docx — NON installare come root globale. Vedere `2DO/server2do.md` per le istruzioni complete. --- Ambiente di sviluppo -------------------- [](#ambiente-di-sviluppo) VoceValoreSistema operativoWSL Ubuntu 18.04 su Windows 10 HomeShellbash (sintassi Unix)PHP8.1FrameworkLaravel 9FrontendTailwind CSS, Alpine.js, Vite 4DatabaseMariaDB 10 (Docker/Sail)CacheRedis (Docker/Sail)App URLAdminerVite dev serverporta 5174--- Installazione ------------- [](#installazione) ### 1. Aggiungere il package come dipendenza locale [](#1-aggiungere-il-package-come-dipendenza-locale) Nel `composer.json` dell'applicazione host, aggiungere il namespace PSR-4 nella sezione `autoload`: ``` "autoload": { "psr-4": { "Elamacchia\\Gespidieffe\\": "package/gespidieffe/src/" } } ``` Quindi copiare la cartella `package/gespidieffe/` nella propria applicazione e rigenerare l'autoload: ``` composer dump-autoload ``` ### 2. Registrare il Service Provider [](#2-registrare-il-service-provider) In `config/app.php`, aggiungere nella sezione `providers`: ``` Elamacchia\Gespidieffe\GespidieffeServiceProvider::class, ``` > Il package supporta anche l'auto-discovery tramite il campo `extra.laravel.providers` nel proprio `composer.json`. ### 3. Verificare le dipendenze di sistema [](#3-verificare-le-dipendenze-di-sistema) Assicurarsi che `qpdf`, `ghostscript` e `pdftk` siano installati nel container (vedi sezione *Requisiti*). ### 4. Creare la cartella per i file temporanei [](#4-creare-la-cartella-per-i-file-temporanei) ``` mkdir -p storage/app/gespidieffe/tmp ``` La cartella viene usata per salvare i PDF caricati e i file elaborati durante le sessioni utente. ### 5. Configurare lo scheduler (pulizia automatica) [](#5-configurare-lo-scheduler-pulizia-automatica) GespidiEffe registra automaticamente un task nello scheduler di Laravel che rimuove ogni ora i file temporanei più vecchi di 24 ore. Assicurarsi che il cron di Laravel sia attivo sul server: ``` * * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1 ``` --- Comandi Artisan --------------- [](#comandi-artisan) ComandoDescrizione`php artisan gespidieffe:pulisci-tmp`Elimina i file temporanei più vecchi di 24 ore (default)`php artisan gespidieffe:pulisci-tmp --ore=48`Elimina i file più vecchi di N ore`php artisan gespidieffe:azzera-contatori`Azzera manualmente tutti i contatori (giornalieri, settimanali, globali) e salva lo storico--- Route ----- [](#route) Tutte le route sono protette dal middleware `['web', 'auth:sanctum', 'verified']`: solo gli utenti autenticati e verificati possono accedere. I guest vengono reindirizzati automaticamente al login da Sanctum/Jetstream. Prefix URI: `/gespidieffe` — Named prefix: `gespidieffe.` MetodoURINome routeGET`/gespidieffe/``gespidieffe.home`GET`/gespidieffe/censura``gespidieffe.censura`POST`/gespidieffe/censura/upload``gespidieffe.censura.upload`GET`/gespidieffe/censura/editor/{file}``gespidieffe.censura.editor`POST`/gespidieffe/censura/applica``gespidieffe.censura.applica`GET`/gespidieffe/censura/download/{file}``gespidieffe.censura.download`DELETE/POST`/gespidieffe/censura/elimina/{file}``gespidieffe.censura.elimina`GET`/gespidieffe/censura/pdf/{file}``gespidieffe.censura.pdf`GET`/gespidieffe/merge``gespidieffe.merge`POST`/gespidieffe/merge/upload``gespidieffe.merge.upload`GET`/gespidieffe/merge/editor/{session}``gespidieffe.merge.editor`GET`/gespidieffe/merge/aggiungi/{session}``gespidieffe.merge.aggiungi`POST`/gespidieffe/merge/applica``gespidieffe.merge.applica`GET`/gespidieffe/merge/download/{file}``gespidieffe.merge.download`DELETE/POST`/gespidieffe/merge/elimina/{session}``gespidieffe.merge.elimina`GET`/gespidieffe/merge/pdf/{session}/{index}``gespidieffe.merge.pdf`GET`/gespidieffe/split``gespidieffe.split`POST`/gespidieffe/split/upload``gespidieffe.split.upload`GET`/gespidieffe/split/editor/{file}``gespidieffe.split.editor`POST`/gespidieffe/split/applica``gespidieffe.split.applica`GET`/gespidieffe/split/download/{file}``gespidieffe.split.download`GET`/gespidieffe/split/download-zip/{file}``gespidieffe.split.download-zip`DELETE/POST`/gespidieffe/split/elimina/{file}``gespidieffe.split.elimina`GET`/gespidieffe/split/pdf/{file}``gespidieffe.split.pdf`GET`/gespidieffe/organizza``gespidieffe.organizza`POST`/gespidieffe/organizza/upload``gespidieffe.organizza.upload`GET`/gespidieffe/organizza/editor/{file}``gespidieffe.organizza.editor`POST`/gespidieffe/organizza/applica``gespidieffe.organizza.applica`GET`/gespidieffe/organizza/download/{file}``gespidieffe.organizza.download`DELETE/POST`/gespidieffe/organizza/elimina/{file}``gespidieffe.organizza.elimina`GET`/gespidieffe/organizza/pdf/{file}``gespidieffe.organizza.pdf`GET`/gespidieffe/ruota``gespidieffe.ruota`POST`/gespidieffe/ruota/upload``gespidieffe.ruota.upload`GET`/gespidieffe/ruota/editor/{file}``gespidieffe.ruota.editor`POST`/gespidieffe/ruota/applica``gespidieffe.ruota.applica`GET`/gespidieffe/ruota/download/{file}``gespidieffe.ruota.download`DELETE/POST`/gespidieffe/ruota/elimina/{file}``gespidieffe.ruota.elimina`GET`/gespidieffe/ruota/pdf/{file}``gespidieffe.ruota.pdf`GET`/gespidieffe/numera``gespidieffe.numera`POST`/gespidieffe/numera/upload``gespidieffe.numera.upload`GET`/gespidieffe/numera/editor/{file}``gespidieffe.numera.editor`POST`/gespidieffe/numera/applica``gespidieffe.numera.applica`GET`/gespidieffe/numera/download/{file}``gespidieffe.numera.download`DELETE/POST`/gespidieffe/numera/elimina/{file}``gespidieffe.numera.elimina`GET`/gespidieffe/numera/pdf/{file}``gespidieffe.numera.pdf`GET`/gespidieffe/unisci-organizza``gespidieffe.unisciorganizza`POST`/gespidieffe/unisci-organizza/upload``gespidieffe.unisciorganizza.upload`GET`/gespidieffe/unisci-organizza/aggiungi/{session}``gespidieffe.unisciorganizza.aggiungi`GET`/gespidieffe/unisci-organizza/editor-merge/{session}``gespidieffe.unisciorganizza.editor-merge`GET`/gespidieffe/unisci-organizza/pdf-merge/{session}/{index}``gespidieffe.unisciorganizza.pdf-merge`POST`/gespidieffe/unisci-organizza/applica-merge``gespidieffe.unisciorganizza.applica-merge`GET`/gespidieffe/unisci-organizza/editor-organizza/{session}``gespidieffe.unisciorganizza.editor-organizza`GET`/gespidieffe/unisci-organizza/pdf-organizza/{session}``gespidieffe.unisciorganizza.pdf-organizza`POST`/gespidieffe/unisci-organizza/applica-organizza``gespidieffe.unisciorganizza.applica-organizza`GET`/gespidieffe/unisci-organizza/download/{file}``gespidieffe.unisciorganizza.download`DELETE/POST`/gespidieffe/unisci-organizza/elimina/{session}``gespidieffe.unisciorganizza.elimina`GET`/gespidieffe/statistiche``gespidieffe.statistiche`GET`/gespidieffe/pdf2word``gespidieffe.pdf2word`POST`/gespidieffe/pdf2word/upload``gespidieffe.pdf2word.upload`GET`/gespidieffe/pdf2word/confirm/{file}``gespidieffe.pdf2word.confirm`POST`/gespidieffe/pdf2word/applica``gespidieffe.pdf2word.applica`GET`/gespidieffe/pdf2word/download/{file}``gespidieffe.pdf2word.download`DELETE/POST`/gespidieffe/pdf2word/elimina/{file}``gespidieffe.pdf2word.elimina`> La route `/statistiche` richiede il middleware aggiuntivo `permission:usa gespidieffe` (Spatie Laravel Permission). --- Architettura: flusso multi-step ------------------------------- [](#architettura-flusso-multi-step) Ogni funzione segue questo schema a cinque fasi: ``` 1. Upload → validazione → salva in storage/app/gespidieffe/tmp/{uuid}.pdf → redirect all'editor 2. Editor → anteprima pagine con PDF.js (client-side) → Alpine.js per interazione utente 3. Elaborazione → POST con parametri operazione → manipolazione server-side (qpdf / Ghostscript / TCPDF / pdftk) → risposta JSON con { download_token } 4. Download → GET con token → response()->download() 5. Pulizia → DELETE/POST elimina file della sessione → scheduler rimuove automaticamente file > 24h ``` ### Flusso speciale: Unisci e Organizza (3 passi) [](#flusso-speciale-unisci-e-organizza-3-passi) La funzione **Unisci e Organizza** usa un flusso esteso a tre passi con una sessione UUID condivisa: ``` Passo 1 – Upload → POST /unisci-organizza/upload → Salva i file come {session}_uo_f0.pdf, {session}_uo_f1.pdf, … → Crea manifest JSON ({session}_uo_manifest.json) → Redirect a editor-merge Passo 2 – Editor Merge (ordina i file) → GET /unisci-organizza/editor-merge/{session} → Thumbnails via /pdf-merge/{session}/{index} (serve il file originale Nth) → POST /unisci-organizza/applica-merge → qpdf unisce i file nell'ordine scelto → {session}_uo_merged.pdf → Risposta JSON { redirect: url_editor_organizza } (NON download_token) → JS naviga a editor-organizza Passo 3 – Editor Organizza (riordina/duplica/elimina pagine) → GET /unisci-organizza/editor-organizza/{session} → Thumbnails via /pdf-organizza/{session} (serve _uo_merged.pdf) → POST /unisci-organizza/applica-organizza → qpdf riorganizza le pagine → {session}_uo_finale.pdf → Risposta JSON { download_token } → Download via /unisci-organizza/download/{token} Pulizia → DELETE/POST /unisci-organizza/elimina/{session} → Rimuove tutti i file {session}_uo* → Flag window._uoSkipCleanup evita il beacon su navigazione interna ``` **Colori UI:** arancione (`#ea580c` / `#f97316`) con inline CSS (Tailwind CDN 2.x non include le classi `orange-*`). ### File temporanei [](#file-temporanei) - Cartella: `storage/app/gespidieffe/tmp/` - Naming standard: `{uuid}.pdf` (originale), `{uuid}_.pdf` (output) - Naming Unisci e Organizza: `{session}_uo_f{N}.pdf`, `{session}_uo_manifest.json`, `{session}_uo_merged.pdf`, `{session}_uo_finale.pdf` --- Struttura del package --------------------- [](#struttura-del-package) ``` package/gespidieffe/ ├── composer.json └── src/ ├── GespidieffeServiceProvider.php ├── Console/ │ ├── PulisciTmpCommand.php │ └── AzzeraContatoriCommand.php ├── Http/Controllers/ │ ├── GespidieffeController.php │ ├── CensuraPdfController.php │ ├── MergePdfController.php │ ├── SplitPdfController.php │ ├── OrganizzaPdfController.php │ ├── RuotaPdfController.php │ ├── NumeraPdfController.php │ ├── UnisciOrganizzaController.php │ └── StatisticheController.php ├── Models/ │ ├── GespidieffeContatore.php │ └── GespidieffeStoricoSettimanale.php ├── Services/ │ └── ContatorePdfService.php ├── database/migrations/ │ ├── 2024_01_01_000001_create_gespidieffe_contatori_table.php │ └── 2024_01_01_000002_create_gespidieffe_storico_settimanale_table.php ├── routes/ │ └── web.php └── resources/views/ ├── layouts/app.blade.php ├── home.blade.php ├── statistiche/ │ └── index.blade.php ├── censura/ │ ├── upload.blade.php │ └── editor.blade.php ├── merge/ │ ├── upload.blade.php │ └── editor.blade.php ├── split/ │ ├── upload.blade.php │ └── editor.blade.php ├── organizza/ │ ├── upload.blade.php │ └── editor.blade.php ├── ruota/ │ ├── upload.blade.php │ └── editor.blade.php ├── numera/ │ ├── upload.blade.php │ └── editor.blade.php ├── unisciorganizza/ │ ├── upload.blade.php │ ├── editor-merge.blade.php │ └── editor-organizza.blade.php └── pdftoword/ └── upload.blade.php ``` --- Architettura: flusso PDF to Word -------------------------------- [](#architettura-flusso-pdf-to-word) La funzione **PDF to Word** usa un flusso a 2 step con rilevamento automatico del tipo di PDF. ### Step 1 — Rilevamento tipo PDF [](#step-1--rilevamento-tipo-pdf) Il controller analizza il PDF con tre strumenti in sequenza: 1. **`qpdf --show-npages`** — conta le pagine 2. **`pdfinfo`** — legge le dimensioni della pagina in punti PDF 3. **`pdfimages -list`** — elenca le immagini con dimensioni in pixel e DPI Per ogni immagine viene calcolata la **copertura percentuale** rispetto alla pagina: ``` imgPtW = imgPixelW / xDPI * 72 imgPtH = imgPixelH / yDPI * 72 copertura = (imgPtW × imgPtH) / (paginaPtW × paginaPtH) ``` Se `copertura >= 0.85` → l'immagine copre la pagina intera. 4. **`pdftotext`** — estrae il testo (incluso OCR invisibile) ### Classificazione [](#classificazione) Immagini a piena paginaTesto estraibile (≥20 chars)TipoBadge UINoSì`nativo`verdeNoNo`scansionato`arancioSì (tutte le pagine)Sì`ibrido`blu — OCR invisibile già presente (es. ScanSnap)Sì (tutte le pagine)No`scansionato`arancioSì (alcune pagine)Sì`ibrido`bluSì (alcune pagine)No`scansionato`arancio### Step 2 — Conversione in base al tipo [](#step-2--conversione-in-base-al-tipo) TipoStrumentoQualità`nativo`**pdf2docx** (Python)Layout, tabelle, immagini preservati`ibrido`**pdftotext -layout** → **Pandoc** → `.docx`Testo strutturato; immagini perse. Usa l'OCR invisibile già presente nel PDF senza rifarlo`scansionato`**Ghostscript** (rasterizza 300 DPI) → **Tesseract** OCR (ita+eng) → **Pandoc** → `.docx`Solo testo; layout perso### Note sul tipo ibrido [](#note-sul-tipo-ibrido) I PDF prodotti da scanner fisici (es. **ScanSnap**, Adobe PDF Scan Library) contengono: - Immagini a piena pagina come contenuto principale - Un layer di testo OCR invisibile sovrapposto, generato automaticamente dallo scanner `pdfimages` rileva le immagini a piena pagina; `pdftotext` estrae il testo OCR invisibile già presente. Invece di rifare l'OCR con Tesseract (più lento, qualità variabile), il flusso ibrido riutilizza il testo già estratto dallo scanner (qualità solitamente superiore). ### File temporanei [](#file-temporanei-1) - Naming: `{uuid}.pdf` (originale), `{uuid}_pdf2word.docx` (output) - Cleanup: glob `{uuid}*` — eliminati al `beforeunload` (se non si scarica) e dallo scheduler orario --- Identificativi -------------- [](#identificativi) VoceValoreNome Composer`elamacchia/gespidieffe`Namespace PHP`Elamacchia\Gespidieffe\`Namespace view`gespidieffe::`Service Provider`Elamacchia\Gespidieffe\GespidieffeServiceProvider`LicenzaMITAutoreEnzo Lamacchia — --- Licenza ------- [](#licenza) Distribuito sotto licenza [MIT](https://opensource.org/licenses/MIT). ### Health Score 18 — LowBetter than 8% of packages Maintenance55 Moderate activity, may be stable Popularity0 Limited adoption so far Community6 Small or concentrated contributor base Maturity12 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://avatars.githubusercontent.com/u/77725032?v=4)[Enzo Lamacchia](/maintainers/EnzoLamacchia)[@EnzoLamacchia](https://github.com/EnzoLamacchia) --- Top Contributors [![EnzoLamacchia](https://avatars.githubusercontent.com/u/77725032?v=4)](https://github.com/EnzoLamacchia "EnzoLamacchia (7 commits)") ### Embed Badge ![Health badge](/badges/elamacchia-gespidieffe/health.svg) ``` [![Health](https://phpackages.com/badges/elamacchia-gespidieffe/health.svg)](https://phpackages.com/packages/elamacchia-gespidieffe) ``` ### Alternatives [42coders/document-templates Document template management package. 19940.0k](/packages/42coders-document-templates)[qipsius/tcpdf-bundle A bundle to easily integrate TCPDF into Symfony 23749.5k](/packages/qipsius-tcpdf-bundle)[macopedia/magmi2 Magento Mass Importer 'Magmi' for Magento 2 11615.7k](/packages/macopedia-magmi2)[tarfin-labs/easy-pdf Makes pdf processing easy. 1719.4k](/packages/tarfin-labs-easy-pdf)[ikkez/f3-sheet Some Excel and CSV utilities for PHP Fat-Free Framework 1414.8k](/packages/ikkez-f3-sheet)[nilgems/laravel-textract A Laravel package to extract text from files like DOC, XL, Image, Pdf and more. I've developed this package by inspiring "npm textract". 195.7k](/packages/nilgems-laravel-textract) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)