Enable zlib in runtime image and pin phpdoc-md for PHP 5.3

Author: MekDrop

Dockerfile

@@ -14,6 +14,10 @@ RUN /usr/local/bin/setup-phpdocumentor-cache.sh /opt/phpdocumentor-cache "$PHPDO
 
 FROM php:${PHP_VERSION}-cli
 
+COPY --chmod=0755 bin/install-runtime-zlib.sh /usr/local/bin/install-runtime-zlib.sh
+RUN /usr/local/bin/install-runtime-zlib.sh \
+    && rm -f /usr/local/bin/install-runtime-zlib.sh
+
 COPY --from=phpdocmd-builder /opt/phpdoc-md /opt/phpdoc-md
 COPY --from=phpdocmd-builder /opt/phpdocumentor-cache /opt/phpdocumentor-cache
 COPY --chmod=0755 bin/entrypoint.sh /usr/local/bin/entrypoint.sh

bin/entrypoint.sh

@@ -64,15 +64,11 @@ else
   PHPDOC_VERSION_NO_PREFIX=${PHPDOC_VERSION#v}
   CACHED_PHPDOC_TAR_GZ_PATH="$PHPDOC_CACHE_PATH/phpDocumentor-${PHPDOC_VERSION_NO_PREFIX}.tgz"
   CACHED_PHPDOC_PHAR_PATH="$PHPDOC_CACHE_PATH/phpDocumentor-${PHPDOC_VERSION_NO_PREFIX}.phar"
-  CACHED_PHPDOC_BIN_PATH="$PHPDOC_CACHE_PATH/phpDocumentor-${PHPDOC_VERSION_NO_PREFIX}/bin/phpdoc"
   PHPDOC_TAR_GZ_URL="https://github.com/phpDocumentor/phpDocumentor/releases/download/v${PHPDOC_VERSION_NO_PREFIX}/phpDocumentor-${PHPDOC_VERSION_NO_PREFIX}.tgz"
   PHPDOC_PHAR_URL="https://github.com/phpDocumentor/phpDocumentor/releases/download/v${PHPDOC_VERSION_NO_PREFIX}/phpDocumentor.phar"
 
   if ! php -r 'exit(extension_loaded("zlib") ? 0 : 1);'; then
-    if [[ -f "$CACHED_PHPDOC_BIN_PATH" ]]; then
-      PHPDOC_COMMAND=(php "$CACHED_PHPDOC_BIN_PATH")
-      PHPDOC_COMMAND_SET=1
-    elif [[ -f "$CACHED_PHPDOC_PHAR_PATH" ]]; then
+    if [[ -f "$CACHED_PHPDOC_PHAR_PATH" ]]; then
       cp "$CACHED_PHPDOC_PHAR_PATH" "$PHPDOC_PHAR_PATH"
       PHPDOC_COMMAND=(php "$PHPDOC_PHAR_PATH" run)
       PHPDOC_COMMAND_SET=1

bin/install-runtime-zlib.sh

@@ -0,0 +1,28 @@
+#!/bin/sh
+
+set -eu
+
+if php -r 'exit(extension_loaded("zlib") ? 0 : 1);'; then
+  exit 0
+fi
+
+if php -d extension=zlib.so -r 'exit(function_exists("gzcompress") ? 0 : 1);'; then
+  echo "extension=zlib.so" > /usr/local/etc/php/conf.d/zz-zlib.ini
+  exit 0
+fi
+
+if ! command -v apt-get >/dev/null 2>&1 || ! command -v docker-php-ext-install >/dev/null 2>&1; then
+  echo "Unable to install zlib extension automatically." >&2
+  exit 1
+fi
+
+apt-get update
+if [ -n "${PHPIZE_DEPS:-}" ]; then
+  apt-get install -y --no-install-recommends $PHPIZE_DEPS zlib1g-dev
+else
+  apt-get install -y --no-install-recommends zlib1g-dev
+fi
+docker-php-ext-install zlib
+rm -rf /var/lib/apt/lists/*
+
+php -r 'if (!function_exists("gzcompress")) { fwrite(STDERR, "zlib extension is required but unavailable.\n"); exit(1); }'

bin/setup-phpdoc-md.sh

@@ -4,11 +4,12 @@ set -euo pipefail
 
 TARGET_DIR=${1:-/opt/phpdoc-md}
 COMPOSER_HOME_DIR=${2:-/tmp/composer}
+PHPDOC_MD_REF=${3:-0.1.1}
 
 GIT_SSH_OPTIONS="ssh -o BatchMode=yes -o StrictHostKeyChecking=accept-new -o ConnectTimeout=5"
 
-if ! GIT_SSH_COMMAND="$GIT_SSH_OPTIONS" git clone --depth 1 git@github.com:evert/phpdoc-md.git "$TARGET_DIR"; then
-  git clone --depth 1 https://github.com/evert/phpdoc-md.git "$TARGET_DIR"
+if ! GIT_SSH_COMMAND="$GIT_SSH_OPTIONS" git clone --depth 1 --branch "$PHPDOC_MD_REF" git@github.com:evert/phpdoc-md.git "$TARGET_DIR"; then
+  git clone --depth 1 --branch "$PHPDOC_MD_REF" https://github.com/evert/phpdoc-md.git "$TARGET_DIR"
 fi
 
 php -r '$composer = json_decode(file_get_contents($argv[1]), true); unset($composer["require-dev"]); file_put_contents($argv[1], json_encode($composer, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES) . PHP_EOL);' "$TARGET_DIR/composer.json"

bin/setup-phpdocumentor-cache.sh

@@ -9,15 +9,8 @@ PHPDOC_TAR_GZ_URL="https://github.com/phpDocumentor/phpDocumentor/releases/downl
 PHPDOC_PHAR_URL="https://github.com/phpDocumentor/phpDocumentor/releases/download/v${PHPDOC_VERSION_NO_PREFIX}/phpDocumentor.phar"
 TARGET_FILE="${TARGET_DIR}/phpDocumentor-${PHPDOC_VERSION_NO_PREFIX}.tgz"
 PHAR_TARGET_FILE="${TARGET_DIR}/phpDocumentor-${PHPDOC_VERSION_NO_PREFIX}.phar"
-EXTRACTED_ROOT="${TARGET_DIR}/phpDocumentor-${PHPDOC_VERSION_NO_PREFIX}"
-XML_WRITER_PATH="${EXTRACTED_ROOT}/src/phpDocumentor/Plugin/Core/Transformer/Writer/Xml.php"
 
 mkdir -p "$TARGET_DIR"
 
 php -r '$url = isset($argv[1]) ? $argv[1] : null; $target = isset($argv[2]) ? $argv[2] : null; if (!$url || !$target) { fwrite(STDERR, "Missing download arguments\n"); exit(1); } $data = @file_get_contents($url); if ($data === false) { fwrite(STDERR, "Unable to download file: $url\n"); exit(1); } if (@file_put_contents($target, $data) === false) { fwrite(STDERR, "Unable to write file: $target\n"); exit(1); }' "$PHPDOC_TAR_GZ_URL" "$TARGET_FILE"
 php -r '$url = isset($argv[1]) ? $argv[1] : null; $target = isset($argv[2]) ? $argv[2] : null; if (!$url || !$target) { fwrite(STDERR, "Missing download arguments\n"); exit(1); } $data = @file_get_contents($url); if ($data === false) { fwrite(STDERR, "Unable to download file: $url\n"); exit(1); } if (@file_put_contents($target, $data) === false) { fwrite(STDERR, "Unable to write file: $target\n"); exit(1); }' "$PHPDOC_PHAR_URL" "$PHAR_TARGET_FILE"
-
-rm -rf "$EXTRACTED_ROOT"
-php -r '$archive = isset($argv[1]) ? $argv[1] : null; $target = isset($argv[2]) ? $argv[2] : null; if (!$archive || !$target) { fwrite(STDERR, "Missing extract arguments\n"); exit(1); } if (!is_dir(dirname($target)) && !mkdir(dirname($target), 0777, true)) { fwrite(STDERR, "Unable to create target parent directory\n"); exit(1); } $root = dirname($target); $tarPath = preg_replace("/\\.tgz$/", ".tar", $archive); if ($tarPath === null) { fwrite(STDERR, "Unable to derive tar path\n"); exit(1); } try { if (!file_exists($tarPath)) { $tgz = new PharData($archive); $tgz->decompress(); } $tar = new PharData($tarPath); $tar->extractTo($root, null, true); } catch (Exception $e) { fwrite(STDERR, "Unable to extract phpDocumentor archive: " . $e->getMessage() . "\n"); exit(1); }' "$TARGET_FILE" "$EXTRACTED_ROOT"
-
-php -r '$path = isset($argv[1]) ? $argv[1] : null; if (!$path || !file_exists($path)) { fwrite(STDERR, "Xml writer file not found: " . ($path ?: "null") . "\n"); exit(1); } $content = file_get_contents($path); if ($content === false) { fwrite(STDERR, "Unable to read xml writer file\n"); exit(1); } $needle = '\''base64_encode(gzcompress($file->getSource()))'\''; $replacement = '\''(function_exists("gzcompress") ? base64_encode(gzcompress($file->getSource())) : "")'\''; $updated = str_replace($needle, $replacement, $content, $count); if ($count < 1) { fwrite(STDERR, "Unable to patch xml writer for missing zlib support\n"); exit(1); } if (file_put_contents($path, $updated) === false) { fwrite(STDERR, "Unable to write patched xml writer file\n"); exit(1); }' "$XML_WRITER_PATH"