Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion public/admin.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,8 @@ A fast, reliable way to manage the records in your database with a simple table-
- [View on GitHub](https://github.com/dotkernel/admin)
- [Live demo](https://admin7.dotkernel.net/)

PHP 8.3, 8.4 or 8.5 . [Latest release](https://github.com/dotkernel/admin/releases/latest)

| | |
| --- | --- |
| Runtime | Mezzio + Laminas |
Expand Down Expand Up @@ -210,7 +212,7 @@ If the fixtures ran, sign in with user `admin` and password `dotadmin` - the sam
| Operating system | A \*nix based system is strongly recommended for production. |
| PHP | 8.3 or newer, mod_php or FCGI (FPM). `memory_limit` at least 128M; `upload_max_filesize` and `post_max_size` at least 100M depending on your data. |
| Web server | Apache 2.2+ with `mod_rewrite` and `.htaccess` support (`AllowOverride All`) - a default `.htaccess` ships in `public/`. On Nginx, translate it into server configuration. |
| Database | MariaDB 10.7, 10.11 LTS, 11.4 LTS and 11.8 LTS, or PostgreSQL 13 and above. **MySQL is not supported**, as it has no UUID support. |
| Database | MariaDB 11.4 LTS, 11.8 LTS and 12.3 LTS, or PostgreSQL 13 and above. **MySQL is not supported**, as it has no UUID support. |
| Required extensions | `mbstring`, the CLI SAPI for cron jobs, and Composer available on `$PATH`. |
| Recommended extensions | `opcache`; `pdo_mysql`, `pdo_pgsql` or `mysqli` to match your database; `dom` and `simplexml` for markup; `gd` and `exif` for images; `zlib`, `zip`, `bz2` for compression; `curl` when calling APIs; `sqlite3` for the test suite. |

Expand Down
10 changes: 6 additions & 4 deletions public/api.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,8 @@ OAuth 2.0, RBAC authorization, HAL payloads, standardized error responses and an
- [View on GitHub](https://github.com/dotkernel/api)
- [Live demo](https://api.dotkernel.net/)

PHP 8.3, 8.4 or 8.5 . [Latest release](https://github.com/dotkernel/api/releases/latest)

| | |
| --- | --- |
| Runtime | Mezzio + Laminas |
Expand Down Expand Up @@ -130,11 +132,11 @@ You keep full control of the UUID version without depending on database extensio
### PostgreSQL support

PostgreSQL joins the supported databases.
Because native UUID is required, you need PostgreSQL or MariaDB 10.7 or later; MySQL is no longer supported, as it has no UUID data type.
Because native UUID is required, you need PostgreSQL 13+ or MariaDB 11.4 or later; MySQL is no longer supported, as it has no UUID data type.

### PHP 8.5

The API targets PHP 8.5, with Dotkernel Admin on 8.4.
The API and Admin target PHP 8.5.
Dependencies are kept current, and the ecosystem's own packages track the versions Laminas and Doctrine support.

### Table prefixes
Expand Down Expand Up @@ -176,7 +178,7 @@ The comparison below is drawn from the full side-by-side write-up on our blog.
| First release | 2012 | 2018 |
| Architecture | MVC, event driven | Middleware |
| OSS lifecycle | Archived | Active |
| PHP version | ≤ 8.2 | See the PHP version badge for `dotkernel/api` |
| PHP version | ≤ 8.2 | 8.3, 8.4 or 8.5 |
| Style | REST, RPC | REST |
| Change management | Versioning | Deprecations (API evolution) |
| Documentation | Swagger (automated) | OpenAPI 3.0 (Swagger) and Postman (manual) |
Expand Down Expand Up @@ -283,7 +285,7 @@ Updates arrive with bugfixes and improvements from the PHP community, and breaki

## Install it and call an endpoint

Create the project with Composer, point it at PostgreSQL or MariaDB 10.7+, run the migrations, and you have an authenticated REST API with a browsable OpenAPI specification.
Create the project with Composer, point it at PostgreSQL 13+ or MariaDB 11.4+, run the migrations, and you have an authenticated REST API with a browsable OpenAPI specification.

- [Installation guide](https://docs.dotkernel.org/api-documentation/)
- [Try the demo](https://api.dotkernel.net/)
Expand Down
2 changes: 1 addition & 1 deletion public/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ A request enters at the error boundary, passes through routing, negotiation, aut
| Container | PSR-11 |
| Logging | PSR-3 |

## Five phases, 19 stages
## Six phases, 19 stages

Error boundary (1 stage) -> Request preparation (4 stages) -> Routing (4 stages) -> Contract & headers (4 stages) -> Identity (2 stages) -> Dispatch & fallback (4 stages).

Expand Down
1 change: 1 addition & 0 deletions public/css/contact.css

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion public/frontend.md
Original file line number Diff line number Diff line change
Expand Up @@ -221,7 +221,7 @@ Duplicating `local.test.php.dist` gives your tests an in-memory database.
| Required extensions | `curl`, `gettext`, `intl`, `json`, `mbstring`, the CLI SAPI for cron jobs, and Composer on `$PATH`. |
| Recommended extensions | `opcache`; `pdo_mysql` for MySQL or MariaDB; `dom` and `simplexml` for markup; `gd` and `exif` for images; `zlib`, `zip`, `bz2` for compression; `sqlite3` for the test suite. |

Note that Frontend still supports MySQL - unlike API and Admin v7, which require native UUID support and therefore PostgreSQL or MariaDB 10.7+.
Note that Frontend still supports MySQL - unlike API and Admin v7, which require native UUID support and therefore PostgreSQL 13+ or MariaDB 11.4+.

## Where Frontend sits

Expand Down
2 changes: 1 addition & 1 deletion public/js/app.js

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion public/queue.md
Original file line number Diff line number Diff line change
Expand Up @@ -201,7 +201,7 @@ valkey-cli ping

### 4 . Clone and configure

Clone the queue branch, then copy each `.dist` configuration file into place - local, log, messenger and swoole - and fill them in.
Clone the queue repo, then copy each `.dist` configuration file into place - local, log, messenger and swoole - and fill them in.

```shell
git clone https://github.com/dotkernel/queue.git
Expand Down
Loading
Loading