Merge branch 'docker'

Author: eclipxe13

.dockerignore

@@ -0,0 +1,10 @@
+*
+!bin/
+!docs/
+!src/
+!templates/
+!composer.json
+!Dockerfile
+!Docker.README.md
+!LICENSE
+!README.md

.github/workflows/docker.yml

@@ -0,0 +1,43 @@
+name: docker
+on:
+  workflow_dispatch:
+  release:
+    branches: [ "master" ]
+    types: [ "published" ]
+    tags: [ "v*" ]
+
+# Actions
+# docker/setup-buildx-action@v3 https://github.com/marketplace/actions/docker-setup-buildx
+# docker/login-action@v3 https://github.com/marketplace/actions/docker-login
+# docker/metadata-action@v5 https://github.com/marketplace/actions/docker-metadata-action
+# docker/build-push-action@v6 https://github.com/marketplace/actions/build-and-push-docker-images
+
+jobs:
+  docker:
+    name: Docker image
+    runs-on: "ubuntu-latest"
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Set application version
+        run: sed -i "s#@box_git_version@#${{ github.ref_name }}#" bin/*
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+      - name: Extract metadata for Docker
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: "${{ github.repository }}"
+          tags: "type=semver,pattern={{version}}"
+      - name: Build and push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

.github/workflows/publish.yml

@@ -1,6 +1,7 @@
 name: "Create and publish Phar"
 
 on:
+  workflow_dispatch:
   release:
     branches: [ "master" ]
     types: [ "published" ]

Docker.README.md

@@ -0,0 +1,26 @@
+# phpcfdi/cfditopdf dockerfile helper
+
+```shell script
+# get the project repository on folder "cfditopdf"
+git clone https://github.com/phpcfdi/cfditopdf.git cfditopdf
+
+# build the image "cfditopdf" from folder "cfditopdf/"
+docker build --tag cfditopdf cfditopdf/
+
+# remove image cfditopdf
+docker rmi cfditopdf
+```
+
+## Run command
+
+The project is installed on `/opt/source/` and the entry point is the command
+`/usr/local/bin/php /opt/source/bin/cfditopdf`.
+
+```shell
+# show help
+docker run -it --rm --user="$(id -u):$(id -g)" cfditopdf --help
+
+# montar un volumen para ejecutar una conversión
+docker run -it --rm --user="$(id -u):$(id -g)" --volume="${PWD}/files:/files" \
+  cfditopdf /files/cfdis/F-12345.xml /files/pdfs/F-12345.pdf
+```

Dockerfile

@@ -0,0 +1,18 @@
+FROM php:8.4-cli-alpine
+
+COPY . /opt/source
+COPY --from=composer:latest /usr/bin/composer /usr/local/bin/composer
+
+# install git, ext-zip and ext-xsl and ext-gd
+RUN apk add git libzip libxslt freetype libjpeg-turbo libpng \
+    libzip-dev libxslt-dev freetype-dev libjpeg-turbo-dev libpng-dev libzip-dev libxslt-dev && \
+    docker-php-ext-install zip xsl gd && \
+    apk del libzip-dev libxslt-dev freetype-dev libjpeg-turbo-dev libpng-dev libzip-dev libxslt-dev
+
+# build project
+RUN cd /opt/source && \
+    rm -r -f composer.lock vendor && \
+    composer update --no-dev && \
+    composer check-platform-reqs
+
+ENTRYPOINT ["/usr/local/bin/php", "/opt/source/bin/cfditopdf"]

README.md

@@ -37,6 +37,14 @@ $ bin/cfditopdf [options] <cfdi-file> [<pdf-file>]
                             ".xml" extension and suffix ".pdf" extension
 ```
 
+## Basic usage from docker
+
+```shell
+docker run -it --rm --user="$(id -u):$(id -g)" cfditopdf --help
+```
+
+See more information on the [Docker README](Docker.README.md) file.
+
 ## Basic usage as a PHP library
 
 ```php

docs/CHANGELOG.md

@@ -5,6 +5,7 @@
 - Fix compatibility with PHP 8.4.
 - Allow dependence of `eclipxe/cfdiutils` to match versions `^2.31` and `^3.0`.
 - Update license year to 2025.
+- Add Docker Hub public image. Thanks to `@dreglad` for the inspiration.
 
 These changes apply to the development environment: