?

.devcontainer/Dockerfile.dev

@@ -0,0 +1 @@
+FROM ghcr.io/universityradioyork/myradio/dev-base:latest

.devcontainer/devcontainer.json

@@ -0,0 +1,59 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the README at:
+// https://github.com/microsoft/vscode-dev-containers/tree/v0.203.0/containers/docker-existing-docker-compose
+// If you want to run as a non-root user in the container, see .devcontainer/docker-compose.yml.
+{
+	"name": "MyRadio + Postgres, Memcached, Mailhog",
+
+	// Update the 'dockerComposeFile' list if you have more compose files or use different names.
+	// The .devcontainer/docker-compose.yml file contains any overrides you need/want to make.
+	"dockerComposeFile": [
+		"../docker-compose.yml",
+		"docker-compose.yml"
+	],
+
+	"service": "myradio",
+
+	// The optional 'workspaceFolder' property is the path VS Code should open by default when
+	// connected. This is typically a file mount in .devcontainer/docker-compose.yml
+	"workspaceFolder": "/var/www/myradio",
+
+	// Set *default* container specific settings.json values on container create.
+	"settings": {
+		"sqltools.connections": [{
+			"name": "Container database",
+			"driver": "PostgreSQL",
+			"server": "postgres",
+			"previewLimit": 50,
+			"port": 5432,
+			"database": "myradio",
+			"username": "myradio",
+			"password": "myradio"
+		}]
+	},
+
+	// Add the IDs of extensions you want installed when the container is created.
+	"extensions": [
+		"bmewburn.vscode-intelephense-client",
+		"felixfbecker.php-debug",
+		"mtxr.sqltools",
+		"mtxr.sqltools-driver-pg",
+		"whatwedo.twig"
+	],
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	"forwardPorts": [7080, 8025],
+
+	// "initializeCommand": ""
+
+	// Uncomment the next line if you want start specific services in your Docker Compose config.
+	// "runServices": [],
+
+	// Uncomment the next line if you want to keep your containers running after VS Code shuts down.
+	// "shutdownAction": "none",
+
+	// Uncomment the next line to run commands after the container is created - for example installing curl.
+	"postCreateCommand": "COMPOSER_VENDOR_DIR=/workspaces/MyRadio/src/vendor composer install && apachectl restart",
+
+	// Uncomment to connect as a non-root user if you've added one. See https://aka.ms/vscode-remote/containers/non-root.
+	// "remoteUser": "vscode"
+}

.devcontainer/docker-compose.yml

@@ -0,0 +1,25 @@
+version: '3'
+services:
+  # Update this to the name of the service you want to work with in your docker-compose.yml file
+  myradio:
+    # Use a pre-built base image to speed up startup
+    build:
+      context: .
+      dockerfile: .devcontainer/Dockerfile.dev
+
+    # If you want add a non-root user to your Dockerfile, you can use the "remoteUser"
+    # property in devcontainer.json to cause VS Code its sub-processes (terminals, tasks, 
+    # debugging) to execute as the user. Uncomment the next line if you want the entire 
+    # container to run as this user instead. Note that, on Linux, you may need to 
+    # ensure the UID and GID of the container user you create matches your local user. 
+    # See https://aka.ms/vscode-remote/containers/non-root for details.
+    #
+    # user: vscode
+
+    init: true
+
+    volumes:
+      # Update this to wherever you want VS Code to mount the folder of your project
+      - .:/workspaces/MyRadio:cached
+      - ./sample_configs/codespaces-server-name.conf:/etc/apache2/conf-enabled/server-name.conf
+      - ./sample_configs/codespaces-apache.conf:/etc/apache2/sites-available/myradio.conf

.dockerignore

@@ -0,0 +1,2 @@
+src/vendor/
+node_modules/

.eslintignore

@@ -0,0 +1,4 @@
+*.min.js
+src/vendor/*
+src/Public/js/vendor/**/*.js
+src/PublicAPI/rtfm/*

.eslintrc.json

@@ -0,0 +1,16 @@
+{
+    "root": true,
+    "env": {
+        "browser": true,
+        "es6": true,
+        "jquery": true
+    },
+    "extends": "eslint:recommended",
+    "rules": {
+        "indent":          ["error", 2],
+        "linebreak-style": ["error", "unix"],
+        "quotes":          ["error", "double"],
+        "semi":            ["error", "always"],
+        "no-console":      "off"
+    }
+}

.github/workflows/dev-base-image.yml

@@ -0,0 +1,50 @@
+name: Update development base image
+
+on:
+  push:
+    branches: [ master ]
+    paths:
+    - sample_configs/*
+    - composer.*
+    - .github/*
+    - .devcontainer/*
+  workflow_dispatch:
+    inputs:
+      ref:
+        description: Branch, tag, or commit SHA to build against
+        required: false
+        default: master
+      docker-tag:
+        description: Tag to add to the Docker image
+        required: false
+        default: latest
+
+jobs:
+
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        ref: ${{ github.event.inputs.ref || 'master' }}
+    - name: Set up QEMU
+      uses: docker/setup-qemu-action@v3
+
+    - name: Set up Docker Buildx
+      uses: docker/setup-buildx-action@v3
+
+    - name: Docker Login
+      uses: docker/login-action@v1.10.0
+      with:
+        registry: ghcr.io
+        username: ${{ github.actor }}
+        password: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Build and push
+      uses: docker/build-push-action@v6
+      with:
+        platforms: linux/amd64,linux/arm64
+        push: true
+        tags: ghcr.io/universityradioyork/myradio/dev-base:${{ github.event.inputs.docker-tag || 'latest' }}

.gitignore

@@ -1,5 +1,18 @@
-/nbproject
 *.LCK*
-MyRadio_Config.local.php
+MyRadio_Config.local.php*
+util/checkpassword.conf
 *.sw[a-z]
 sftp-*.json
+.sync-config.cson
+.tags*
+Thumbs.db
+cache.properties
+build/
+.phpintel
+.vagrant
+src/vendor
+composer.lock
+node_modules/
+src/Public/img/stats_training_*.svg
+.idea/
+.DS_Store

.travis.yml

@@ -0,0 +1,66 @@
+sudo: required
+dist: trusty # Use notancient unbuntu
+language: php
+php:
+    - '7.1'
+    - '7.2'
+    - '7.3'
+    - '7.4'
+    - 'nightly' # why not
+
+matrix:
+    allow_failures:
+        - php: 'nightly'
+
+cache:
+  directories:
+    - src/vendor
+    - $HOME/.cache/composer/files
+    - node_modules/
+
+addons:
+    postgresql: '9.5'
+services:
+    - postgresql
+before_install:
+  - nvm install --lts  # Updated Node required for eslint
+install:
+    - composer install
+    - npm install eslint
+    - sudo apt-get update
+    - sudo apt-get install apache2 libapache2-mod-fastcgi
+before_script:
+    # missing read perms on $HOME, which apache24 requires
+    - chmod 755 $HOME
+    # enable php-fpm
+    - phpenv config-add sample_configs/travis-php.ini
+    - sudo cp ~/.phpenv/versions/$(phpenv version-name)/etc/php-fpm.conf{.default,}
+    - sudo cp ~/.phpenv/versions/$(phpenv version-name)/etc/php-fpm.d/www.conf{.default,}
+    - sudo a2enmod rewrite actions fastcgi alias
+    - echo "cgi.fix_pathinfo = 1" >> ~/.phpenv/versions/$(phpenv version-name)/etc/php.ini
+    - ~/.phpenv/versions/$(phpenv version-name)/sbin/php-fpm
+    # configure apache virtual hosts
+    - sudo cp -f sample_configs/travis-fpm.conf /etc/apache2/sites-available/myradio-travis.conf
+    - sudo sed -e "s?%TRAVIS_BUILD_DIR%?$(pwd)?g" --in-place /etc/apache2/sites-available/myradio-travis.conf
+    - sudo a2dissite 000-default
+    - sudo a2ensite myradio-travis
+    - sudo service apache2 restart
+    - sudo apachectl -S
+    - sudo cat /etc/apache2/sites-enabled/*
+    # setup postgres
+    - psql -U postgres < sample_configs/postgres.sql
+    - PGPASSWORD=myradio psql -U myradio myradio < schema/base.sql
+    - for f in schema/patches/*.sql; do PGPASSWORD=myradio psql -U myradio myradio < $f; done
+    - PGPASSWORD=myradio psql -U myradio myradio < sample_configs/travis-auth.sql
+    # configure MyRadio
+    - cp sample_configs/travis-config.php src/MyRadio_Config.local.php
+script:
+    - src/vendor/bin/phpcs --standard=PSR2 --ignore="*.min.*,*/vendor/*,*/PublicAPI/rtfm/*,*/Public/js/*" --exclude=Squiz.Classes.ValidClassName,PSR1.Files.SideEffects src/ -p -s
+    - node_modules/.bin/eslint .
+    - curl -v http://localhost/api/v2/config/publicconfig?api_key=travis-test-key
+    - src/vendor/bin/codecept run --debug --env travis
+after_script:
+    - sudo cat $(pwd)/apache-access.log
+    - sudo cat $(pwd)/apache-error.log
+    - sudo cat ~/.phpenv/versions/$(phpenv version-name)/var/log/php-fpm.log
+    - sudo ls -l ~/.phpenv/versions/$(phpenv version-name)/var/log/

.vscode/launch.json

@@ -0,0 +1,14 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Listen for Xdebug",
+            "type": "php",
+            "request": "launch",
+            "port": 9003
+        }
+    ]
+}

Dockerfile

@@ -0,0 +1,59 @@
+FROM php:8.2-apache
+
+RUN apt-get update && apt-get install -y libpq-dev libpng-dev libjpeg-dev libldap-dev unzip \
+                                         libcurl4-openssl-dev libxslt-dev git libz-dev libzip-dev libmemcached-dev \
+                                         postgresql-client jq msmtp-mta ffmpeg
+
+RUN docker-php-ext-install pgsql pdo_pgsql gd ldap curl xsl zip
+
+RUN pecl install memcached && \
+    echo extension=memcached.so >> /usr/local/etc/php/conf.d/memcached.ini
+
+RUN pecl install xdebug-3.3.1 && docker-php-ext-enable xdebug \
+ && echo 'zend_extension="/usr/local/lib/php/extensions/no-debug-non-zts-20220829/xdebug.so"' >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini \
+ && echo 'xdebug.client_port=9003' >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini \
+ && echo 'xdebug.mode=develop,debug' >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini \
+ && echo 'xdebug.start_with_request=yes' >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini \
+ && echo 'xdebug.client_host=localhost' >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini
+
+RUN echo 'error_reporting=E_ALL' >> /usr/local/etc/php/conf.d/error-reporting.ini
+
+RUN echo "memory_limit=512M" >> /usr/local/etc/php/conf.d/uploads.ini
+RUN echo "upload_max_filesize=512M" >> /usr/local/etc/php/conf.d/uploads.ini
+RUN echo "post_max_size=512M" >> /usr/local/etc/php/conf.d/uploads.ini
+
+RUN echo sendmail_path = "/usr/bin/msmtp -t --host mail --port 1025 --from myradio@ury.dev" > /usr/local/etc/php/conf.d/sendmail.ini
+
+# Self-signed certificate
+RUN openssl req -nodes -new -subj "/C=GB/ST=North Yorkshire/L=York/O=University Radio York/OU=Localhost/CN=localhost" > myradio.csr && \
+    openssl rsa -in privkey.pem -out myradio.key && \
+    openssl x509 -in myradio.csr -out myradio.crt -req -signkey myradio.key -days 999 && \
+    cp myradio.crt /etc/apache2/myradio.crt && \
+    cp myradio.key /etc/apache2/myradio.key
+
+RUN a2enmod rewrite ssl
+
+# Fixes for running on ARM
+RUN echo "Mutex posixsem" >> /etc/apache2/apache2.conf
+
+RUN echo "127.0.0.0/8" >> /etc/apache2/trusted-proxies.txt
+
+COPY sample_configs/apache.conf /etc/apache2/sites-available/myradio.conf
+RUN a2enmod remoteip && a2dissite 000-default && a2ensite myradio && apachectl -S
+
+COPY --from=composer:latest /usr/bin/composer /usr/local/bin/composer
+
+RUN mkdir -p /var/www/myradio && chown -R www-data:www-data /var/www/myradio && \
+    mkdir -p /var/log/myradio && chown -R www-data:www-data /var/log/myradio
+
+WORKDIR /var/www/myradio
+COPY composer.* /var/www/myradio/
+RUN COMPOSER_VENDOR_DIR=/var/www/myradio/src/vendor composer install --no-security-blocking
+
+COPY schema schema
+COPY src src
+
+COPY sample_configs/docker-config.php src/MyRadio_Config.local.php
+RUN chown www-data:www-data /var/www/myradio/src/MyRadio_Config.local.php && chmod 664 /var/www/myradio/src/MyRadio_Config.local.php
+
+CMD ["apache2-foreground"]

Dockerfile.prod

@@ -0,0 +1,50 @@
+FROM php:8.2-apache
+
+RUN apt-get update && apt-get install -y libpq-dev libpng-dev libjpeg-dev libldap-dev unzip \
+                                         libcurl4-openssl-dev libxslt-dev git libz-dev libzip-dev libmemcached-dev \
+                                         postgresql-client jq msmtp-mta ffmpeg
+
+RUN docker-php-ext-install pgsql pdo_pgsql gd ldap curl xsl zip
+
+RUN pecl install memcached && \
+    echo extension=memcached.so >> /usr/local/etc/php/conf.d/memcached.ini
+
+RUN echo 'error_reporting=E_ALL' >> /usr/local/etc/php/conf.d/error-reporting.ini
+
+RUN echo "memory_limit=512M" >> /usr/local/etc/php/conf.d/uploads.ini
+RUN echo "upload_max_filesize=512M" >> /usr/local/etc/php/conf.d/uploads.ini
+RUN echo "post_max_size=512M" >> /usr/local/etc/php/conf.d/uploads.ini
+
+RUN echo sendmail_path = "/usr/bin/msmtp -t --host ury.york.ac.uk --port 587 --from noreply@ury.org.uk" > /usr/local/etc/php/conf.d/sendmail.ini
+
+# Self-signed certificate
+RUN openssl req -nodes -new -subj "/C=GB/ST=North Yorkshire/L=York/O=University Radio York/OU=Localhost/CN=localhost" > myradio.csr && \
+    openssl rsa -in privkey.pem -out myradio.key && \
+    openssl x509 -in myradio.csr -out myradio.crt -req -signkey myradio.key -days 999 && \
+    cp myradio.crt /etc/apache2/myradio.crt && \
+    cp myradio.key /etc/apache2/myradio.key
+
+RUN a2enmod rewrite ssl
+
+RUN echo "144.32.64.160/27" >> /etc/apache2/trusted-proxies.txt
+
+COPY sample_configs/apache.conf /etc/apache2/sites-available/myradio.conf
+RUN a2enmod remoteip && a2dissite 000-default && a2ensite myradio && apachectl -S
+
+COPY --from=composer:latest /usr/bin/composer /usr/local/bin/composer
+
+RUN mkdir -p /var/www/myradio && chown -R www-data:www-data /var/www/myradio && \
+    mkdir -p /var/log/myradio && chown -R www-data:www-data /var/log/myradio && \
+    ln -s /dev/stderr /var/log/myradio/errors.log
+
+WORKDIR /var/www/myradio
+COPY composer.* /var/www/myradio/
+RUN COMPOSER_VENDOR_DIR=/var/www/myradio/src/vendor composer install --no-security-blocking
+
+COPY schema schema
+COPY src src
+
+COPY sample_configs/docker-config.php src/MyRadio_Config.local.php
+RUN chown www-data:www-data /var/www/myradio/src/MyRadio_Config.local.php && chmod 664 /var/www/myradio/src/MyRadio_Config.local.php
+
+CMD ["apache2-foreground"]

README.md

@@ -8,7 +8,9 @@ their own community or student radio venture.
 
 MyRadio is part of a suite of upcoming public projects, including:
 - iTones, our liquidsoap sustainer system
-- loggerng, our python audio logging and retriving system
+- loggerng, our python audio logging and retrieving system
 - Bootstrapping scripts for setting up and configuring all the dependencies
 
-MyRadio uses Git-Flow as a development workflow: https://github.com/nvie/gitflow/
+To install myradio locally, see the [Install Guide](docs/install.md)
+
+MyRadio uses [GitHub Flow](https://guides.github.com/overviews/flow/) as a development workflow: