Released Version 0.1.0

Author: null93

.github/workflows/release.yml

@@ -0,0 +1,76 @@
+name: Release workflow
+
+permissions:
+  contents: write
+
+on:
+  push:
+    tags: "*"
+
+jobs:
+  prepare:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        id: create_release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+  build:
+    runs-on: ubuntu-latest
+    needs: prepare
+    strategy:
+      max-parallel: 1
+      matrix:
+        arch:
+          - amd64
+          - arm64
+        php_version:
+          - "7.2"
+          - "7.3"
+          - "7.4"
+          - "8.0"
+          - "8.1"
+          - "8.2"
+          - "8.3"
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v1
+        with:
+          platforms: linux/${{ matrix.arch }}
+      - name: Build nop_${{ matrix.arch }}_${{ matrix.php_version }}.so.out
+        run: |
+          docker run \
+            --rm \
+            -v ${{ github.workspace }}:/workspace \
+            -w /workspace \
+            --platform linux/${{ matrix.arch }} \
+            php:${{ matrix.php_version }}-cli \
+            ./scripts/build-extension
+      - name: Generate nfpm.${{ matrix.arch }}.${{ matrix.php_version }}.yaml
+        run: ./scripts/nfpm-template
+        env:
+          VERSION: ${{ github.ref_name }}
+          ARCH: ${{ matrix.arch }}
+          PHP_VERSION: ${{ matrix.php_version }}
+      - name: Package php${{ matrix.php_version }}-nop_${{ matrix.arch }}_${{ github.ref_name }}.deb
+        run: |
+          docker run \
+            --rm \
+            -v ${{ github.workspace }}:/workspace \
+            -w /workspace \
+            --platform linux/${{ matrix.arch }} \
+            goreleaser/nfpm:v2.41.0 \
+            pkg \
+              --packager deb \
+              --config nfpm.${{ matrix.arch }}.${{ matrix.php_version }}.yaml \
+              --target ./private/php${{ matrix.php_version }}-nop_${{ matrix.arch }}_${{ github.ref_name }}.deb
+      - name: Upload php${{ matrix.php_version }}-nop_${{ matrix.arch }}_${{ github.ref_name }}.deb
+        id: upload-release-asset 
+        uses: softprops/action-gh-release@v2
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          files: ./private/php${{ matrix.php_version }}-nop_${{ matrix.arch }}_${{ github.ref_name }}.deb

.gitignore

@@ -1,6 +1,7 @@
 # Files
 
 .DS_Store
+*.deb
 
 # Directories
 

README.md

@@ -36,7 +36,18 @@ php -d 'extension=nop.so' -d 'nop.functions=' -r 'printf ("hi\n");'
 php -d 'extension=nop.so' -d 'nop.functions=printf' -r 'printf ("hi\n");'
 ```
 
+## Package Extension
+
+```shell
+# Build all inside docker container
+./scripts/build-all
+
+# Package for Debian
+nfpm pkg --packager deb --target ./private/php8.3-nop_0.1.0_arm64.deb
+```
+
 ## Additional Resources
 
 - https://www.phpinternalsbook.com/
 - https://www.zend.com/sites/zend/files/pdfs/whitepaper-zend-php-extensions.pdf
+- https://www.zend.com/resources/writing-php-extensions

conf/nop.ini

@@ -0,0 +1,5 @@
+; php-nop
+extension=nop.so
+
+; comma separated list of functions
+nop.functions=

nfpm.template.yaml

@@ -0,0 +1,20 @@
+name: php-nop
+arch: ${ARCH}
+platform: linux
+version: ${VERSION}
+section: php
+priority: optional
+maintainer: Rafael Grigorian <rafael@grigorian.org>
+homepage: https://github.com/null93/php-nop
+license: MIT
+description: PHP extension that replaces any function with a NOP function
+contents:
+  - src: private/shared-objects/nop_${ARCH}_${PHP_VERSION}.so.out
+    dst: /usr/lib/php/$PHP_API_VERSION/nop.so
+    file_info:
+      mode: 0755
+  - src: conf/nop.ini
+    dst: /etc/php/${PHP_VERSION}/mods-available/nop.ini
+    type: config
+depends:
+  - php-common (>= ${PHP_VERSION})

scripts/build-extension

@@ -0,0 +1,34 @@
+#!/bin/bash
+
+arch=`uname -a | grep -q 'x86_64' && echo 'amd64' || echo 'arm64'`
+php_version=`php -r 'echo PHP_MAJOR_VERSION . "." . PHP_MINOR_VERSION;'`
+output_path="./private/shared-objects/nop_${arch}_${php_version}.so.out"
+
+echo "BUILDING: ${arch} php-${php_version})"
+
+# configure the build
+
+phpize
+./configure
+
+# build the extension and test
+
+make
+make install
+NO_INTERACTION=true make test
+
+# stash the shared object
+
+mkdir -p ./private/shared-objects
+mv ./modules/nop.so "${output_path}"
+
+# clean up
+
+make clean
+
+# output file path
+
+echo
+echo "OUTPUT: ${output_path}"
+echo
+ls -la "${output_path}"

scripts/nfpm-template

@@ -0,0 +1,36 @@
+#!/bin/bash
+
+if [[ "$VERSION" = "" ]]; then
+    echo "Error: VERSION is not set"
+    exit 1
+fi
+
+if [[ "$PHP_VERSION" = "" ]]; then
+    echo "Error: PHP_VERSION is not set"
+    exit 1
+fi
+
+if [[ "$ARCH" = "" ]]; then
+    echo "Error: ARCH is not set"
+    exit 1
+fi
+
+php_api_versions_map=`cat << EOF
+7.2=20170718
+7.3=20180731
+7.4=20190902
+8.0=20200930
+8.1=20210902
+8.2=20220829
+8.3=20230831
+EOF`
+
+export PHP_API_VERSION=`echo "$php_api_versions_map" | grep -E "^${PHP_VERSION}=" | cut -d '=' -f 2 | xargs`
+
+if [[ "$PHP_API_VERSION" = "" ]]; then
+    echo "Error: PHP_API_VERSION is not set"
+    exit 1
+fi
+
+envsubst < nfpm.template.yaml > "nfpm.${ARCH}.${PHP_VERSION}.yaml"
+cat "nfpm.${ARCH}.${PHP_VERSION}.yaml"