waglpz/webapp

Web application component

2.2.0 2025-03-27 19:59 UTC

Requires

• php: ^8.3
• waglpz/webapp-meta: dev-master
• wikimedia/composer-merge-plugin: ^2.1

MIT

README

The Library enables you to work with web application as MVC.

Requirements

PHP 8.2 or higher (see composer json)

Installation

composer require waglpz/webapp

Example public/index.php for testing in browser

<?php

declare(strict_types=1);

/**
* when testing wepapp then create /public Directory as DocumentRoot and insert index.php
*/

use Psr\Http\Message\ServerRequestInterface;
use Symfony\Component\Dotenv\Dotenv;
use Waglpz\Webapp\App;

use function Waglpz\Webapp\container;

require __DIR__ . '/../vendor/autoload.php';

const PROJECT_CONFIG_DIRECTORY = __DIR__ . '/../config';

(new Dotenv())->bootEnv(__DIR__ . '/../.env');

/* phpcs:disable */
if (! \defined('APP_ENV')) {
    \define('APP_ENV', $_SERVER['APP_ENV'] ?? 'dev');
}
/* phpcs:enable */

$container = container();
$app       = $container->get(App::class);
$request   = $container->get(ServerRequestInterface::class);
\assert($app instanceof App && $request instanceof ServerRequestInterface);
$app->run($request);

Docker

Build Docker container included php and composer for working within

docker build --force-rm --build-arg APPUID=$(id -u) --build-arg APPUGID=$(id -g) --tag waglpz/webapp .docker/

Start container with bash

docker run --user $(id -u):$(id -g) --rm -ti -v $PWD:/app -v $PWD/.docker/ waglpz/webapp bash

Start container with bash and xdebug

docker run \
--user $(id -u):$(id -g) \
--rm \
-ti \
-v $PWD:/app \
-v $PWD/.docker/ \
-v $PWD/.docker/php/php-ini-overrides.ini:/usr/local/etc/php/conf.d/99-overrides.ini \
waglpz/webapp bash 

Start container with bash and xdebug as root user eg to install apt get packet

docker run \
--rm \
-ti \
-v $PWD:/app \
-v $PWD/.docker/ \
-v $PWD/.docker/php/php-ini-overrides.ini:/usr/local/etc/php/conf.d/99-overrides.ini \
waglpz/webapp bash 

Code Quality and Testing

To check for coding style violations, run

composer cs-check

To automatically fix (fixable) coding style violations, run

composer cs-fix

To check for static type violations, run

composer cs-fix

To check for regressions, run

composer test

To check all violations at once, run

composer check