My blog's custom software

php slim

PHP 93.5%
Twig 6.5%

Find a file

Alex eea5c98fa8 Improve SqliteCacheStore Only one value will exist for a given key, so use $stmt->fetch instead of fetchAll		2025年02月28日 12:54:24 +01:00
database/sqlite	Add license functionality	2025年02月22日 19:32:41 +01:00
languages	Basic blog post reading	2025年02月12日 16:18:31 +01:00
public	Add license functionality	2025年02月22日 19:32:41 +01:00
scripts	Create a script to create users	2025年02月09日 20:28:22 +01:00
src	Improve SqliteCacheStore	2025年02月28日 12:54:24 +01:00
templates	Add license functionality	2025年02月22日 19:32:41 +01:00
.env.example	Add an Atom feed	2025年02月19日 23:02:21 +01:00
.gitignore	Basic code	2025年02月09日 15:54:50 +01:00
.woodpecker.yaml-unused	Disable CI	2025年02月14日 13:23:33 +01:00
composer.json	Install laminas/laminas-feed	2025年02月19日 22:03:07 +01:00
composer.lock	Update dependencies	2025年02月27日 14:11:45 +01:00
LICENSE	Añadir licencia	2025年02月05日 11:36:20 +01:00
psalm.xml	Create a script to create users	2025年02月09日 20:28:22 +01:00
README.md	Fix	2025年02月21日 15:26:26 +01:00

README.md

YellowComet/Blog

This is my custom blog software.

This is still experimental software in active development! Use at your own risk

Currently not used for my blog due to still being in development, but it will be.

How to install

Make sure you have at least PHP 8.3 with the PDO extension and the SQLite PDO driver, as well as Composer for downloading dependencies.
Clone or download an archive of this repository.
Run composer install --no-dev
Copy .env.example at the root of the repository to .env and modify as needed.
Run SQL from database/ to create the needed tables.
Point your webserver to the public directory and make sure all requests are routed to index.php there (See the Slim framework's guide on webservers for examples).
Run scripts/newUser.php to create an user and API key for you to use when making posts.

API clients

This blog does not have a web-based editor. Instead, it exposes an API endpoint, /api/post, where you can submit posts.

See src/Controller/ApiController.php and src/Middleware/ApiAuthenticationMiddleware.php for more.

I have a small Python script you can use as a client at YellowComet/blog-client, but it's pretty easy to write your own client.

The code

This is a PHP web app based on the Slim framework. It was developed using the Kate code editor and uses Psalm for static analysis. It uses Bulma for CSS.

Dependencies

See composer.json for the direct dependencies and composer.lock for all dependencies and their licenses. Directly, this program uses Slim, the Twig template engine, PHPMailer and phpdotenv, as well as psalm and PHPUnit as dev dependencies.

License

This program is licensed under the European Union Public License 1.2, see LICENSE for the license and Wikipedia for an overview of it. Dependencies of this program have their own licenses.