README

Package Repository Website for Composer, see the about page on packagist.org for more.

This project is not meant for re-use.

It is open source to make it easy to contribute. We provide no support if you want to run your own, and will do breaking changes without notice.

Check out Private Packagist if you want to host your own packages.

Development

These steps are provided for development purposes only.

Requirements

PHP for the web app
NPM (or Docker) for the frontend build
Symfony CLI to run the web server
MySQL (or Docker) for the main data store
Redis (or Docker) for some functionality (favorites, download statistics)
git / svn / hg depending on which repositories you want to support

Installation

Clone the repository
Install dependencies:
```
composer install
npm install
```
Ensure env vars are set up correctly, you probably need to set APP_MAILER_FROM_EMAIL, APP_MAILER_FROM_NAME and APP_DEV_EMAIL_RECIPIENT in .env.local. Set also MAILER_DSN if you'd like to receive email.
Start the web server:
```
symfony serve -d
```
Start MySQL & Redis:
```
docker compose up -d # or somehow run MySQL & Redis on localhost without Docker
```
This mounts the current working directory into the node container and runs npm install and npm run build automatically.

Create 2 databases:

packagist - for the web app
packagist_test - for running the tests

bin/console doctrine:database:create
bin/console doctrine:database:create --env=test

Setup the database schema:
```
bin/console doctrine:schema:create
```
Run a CRON job bin/console packagist:run-workers to make sure packages update.
Run npm run build or npm run dev to build (or build&watch) css/js files. When using Docker run docker compose run node npm run dev to watch css/js files.

You should now be able to access the site, create a user, etc.

Fixtures

You can get test data by running the fixtures:

bin/console doctrine:fixtures:load --group base
bin/console doctrine:fixtures:load --group downloads --append

This will create some packages, update them from GitHub, populate them with fake download stats, and assign a user named dev (with password: dev) as their maintainer.

There is also a user user (with password: user) that has no access if you need to check readonly views.

Finally there is a user admin (with password: admin) that has super admin permissions.

Search

To use the search in your local development environment, setup an Algolia Account and configure following keys in your .env.local:

ALGOLIA_APP_ID=
ALGOLIA_ADMIN_KEY=
ALGOLIA_SEARCH_KEY=
ALGOLIA_INDEX_NAME=

To setup the search index, run:

bin/console algolia:configure
bin/console packagist:index

than-aa / pdf-to-html-th

Maintainers

Details