Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/karmek-k/mijikasa

✂️ My very own link shortener (with a captcha)
https://github.com/karmek-k/mijikasa

link-shortener php php8 symfony

Last synced: about 2 months ago
JSON representation

✂️ My very own link shortener (with a captcha)

Awesome Lists containing this project

README

        

# mijikasa

[![Build Status](https://travis-ci.com/karmek-k/mijikasa.svg?branch=master)](https://travis-ci.com/karmek-k/mijikasa)

This is a simple URL shortener. More features will be added soon!

**Mijikasa** (短さ, *shortness*) is a Japanese word
created from the adjective **mijikai** (短い, *short*)

## Features

- hCaptcha protection
- easy deployment on Heroku

## Installation

Mijikasa requires PHP 8 or greater.
You'll also need Composer and a database (I used PostgreSQL).

1. Install dependencies

`composer install`

2. Either create a `.env.local` file from `.env` template:

`cp .env .env.local`

or provide the environment variables manually.

**PLEASE** make sure that the `APP_ENV` variable
is set to either `dev` or `prod`!
Deploying on the `dev` environment poses a major security risk!

3. Now you can run the built-in PHP web server

`php -S localhost:8000 -t public`

or use a specialized one, such as nginx or Apache.
Make sure that you point it at the `public/` catalog!

## Tests

Running the test suite:

`php bin/phpunit`

hCaptcha is disabled in the `test` environment.

## License

Mijikasa is licensed under the `AGPL-3.0` license.