Update the repo after the fork.

- Changes links in multiple places
- Adds mkdocs instead of github pages, all content copied
- Adds dependabot to mange upgrades of php packages and actions
- Fresh setup for unit tests in github actions to see if the tests work or not
- Adding devcontainer to make it easier to work on this project with a certain php version

Author: Grotax

.devcontainer/Dockerfile

@@ -0,0 +1,39 @@
+FROM php:8.1-cli
+
+# Arguments defined in devcontainer.json
+ARG VARIANT=8.1
+ARG USER_UID=1000
+ARG USER_GID=$USER_UID
+
+# Install packages and PHP extensions based on composer.json requirements
+RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
+    && apt-get install -y --no-install-recommends \
+       git \
+       curl \
+       unzip \
+       zip \
+       libxml2-dev \
+    && docker-php-ext-install -j$(nproc) \
+       dom \
+    && apt-get clean -y && rm -rf /var/lib/apt/lists/*
+
+# Install Xdebug for development
+RUN pecl install xdebug \
+    && docker-php-ext-enable xdebug
+
+# Create a non-root user to use
+RUN groupadd --gid $USER_GID vscode \
+    && useradd --uid $USER_UID --gid $USER_GID -m vscode \
+    && apt-get update \
+    && apt-get install -y sudo \
+    && echo vscode ALL=\(root\) NOPASSWD:ALL > /etc/sudoers.d/vscode \
+    && chmod 0440 /etc/sudoers.d/vscode
+
+# Set up Composer
+COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
+ENV COMPOSER_ALLOW_SUPERUSER=1
+
+# Configure PHP with proper settings for development
+COPY php.ini /usr/local/etc/php/conf.d/php-custom.ini
+
+USER vscode

.devcontainer/devcontainer.json

@@ -0,0 +1,25 @@
+{
+  "name": "PHP Feed-IO",
+  "build": {
+    "dockerfile": "Dockerfile",
+    "args": {
+      "VARIANT": "8.1"
+    }
+  },
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "bmewburn.vscode-intelephense-client",
+        "xdebug.php-debug",
+        "neilbrayfield.php-docblocker",
+        "mehedidracula.php-namespace-resolver"
+      ],
+      "settings": {
+        "php.validate.executablePath": "/usr/local/bin/php"
+      }
+    }
+  },
+  "forwardPorts": [8000],
+  "postCreateCommand": "composer install",
+  "remoteUser": "vscode"
+}

.devcontainer/php.ini

@@ -0,0 +1,9 @@
+; Custom PHP settings for development
+
+memory_limit = 256M
+max_execution_time = 120
+upload_max_filesize = 50M
+post_max_size = 50M
+date.timezone = UTC
+display_errors = On
+error_reporting = E_ALL

.github/dependabot.yml

@@ -0,0 +1,19 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  # Maintain dependencies for Composer
+  - package-ecosystem: "composer"
+    directory: "/"
+    schedule:
+      interval: "daily"
+    versioning-strategy: increase
+
+  # Maintain dependencies for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "daily"

.github/workflows/build-docs.yml

@@ -0,0 +1,25 @@
+name: Publish docs via GitHub Pages
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+
+jobs:
+  build:
+    name: Deploy docs
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout main
+        uses: actions/checkout@v4
+
+      - name: Deploy docs
+        uses: mhausenblas/mkdocs-deploy-gh-pages@master
+        # Or use mhausenblas/mkdocs-deploy-gh-pages@nomaterial to build without the mkdocs-material theme
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          #CUSTOM_DOMAIN: optionaldomain.com
+          #CONFIG_FILE: folder/mkdocs.yml
+          #EXTRA_PACKAGES: build-base
+          # GITHUB_DOMAIN: github.myenterprise.com

.github/workflows/ci.yml

@@ -0,0 +1,39 @@
+name: Unit Tests
+
+on:
+  pull_request:
+    branches: [ main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    
+    strategy:
+      matrix:
+        php-version: ['8.1', '8.2', '8.3', '8.4']
+      fail-fast: false
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Setup PHP
+      uses: shivammathur/setup-php@v2
+      with:
+        php-version: ${{ matrix.php-version }}
+        extensions: dom, json, libxml
+        coverage: xdebug
+    
+    - name: Cache Composer packages
+      id: composer-cache
+      uses: actions/cache@v3
+      with:
+        path: vendor
+        key: ${{ runner.os }}-php-${{ matrix.php-version }}-${{ hashFiles('**/composer.lock') }}
+        restore-keys: |
+          ${{ runner.os }}-php-${{ matrix.php-version }}-
+    
+    - name: Install dependencies
+      run: composer install --prefer-dist --no-progress
+    
+    - name: Run test suite
+      run: make test

.github/workflows/unit-tests.yml

@@ -4,3 +4,4 @@ vendor/
 .phpunit.result.cache
 .php-cs-fixer.cache
 phpunit.xml
+.vscode/