webdl / bestwishes
Multilingual wishlist application
Requires
- php: >=8.3.37
- ext-ctype: *
- ext-iconv: *
- doctrine/doctrine-bundle: ^2.18
- doctrine/doctrine-migrations-bundle: ^3.7
- doctrine/orm: ^3.5
- friendsofsymfony/jsrouting-bundle: ^3.6
- phpdocumentor/reflection-docblock: ^5.6
- phpstan/phpdoc-parser: ^2.3
- sentry/sentry-symfony: ^5.8
- stof/doctrine-extensions-bundle: ^1.12
- symfony/amqp-messenger: 7.4.*
- symfony/asset: 7.4.*
- symfony/console: 7.4.*
- symfony/doctrine-messenger: 7.4.*
- symfony/dotenv: 7.4.*
- symfony/expression-language: 7.4.*
- symfony/flex: ^2
- symfony/form: 7.4.*
- symfony/framework-bundle: 7.4.*
- symfony/http-client: 7.4.*
- symfony/intl: 7.4.*
- symfony/mailer: 7.4.*
- symfony/mime: 7.4.*
- symfony/monolog-bundle: ^3.0|^4.0
- symfony/notifier: 7.4.*
- symfony/process: 7.4.*
- symfony/property-access: 7.4.*
- symfony/property-info: 7.4.*
- symfony/runtime: 7.4.*
- symfony/security-bundle: 7.4.*
- symfony/serializer: 7.4.*
- symfony/string: 7.4.*
- symfony/translation: 7.4.*
- symfony/twig-bundle: 7.4.*
- symfony/validator: 7.4.*
- symfony/web-link: 7.4.*
- symfony/webpack-encore-bundle: ^2.2
- symfony/yaml: 7.4.*
- symfonycasts/reset-password-bundle: ^1.24
- twig/extra-bundle: ^2.12|^3.0
- twig/twig: ^2.12|^3.0
Requires (Dev)
- doctrine/doctrine-fixtures-bundle: ^3.7
- friendsofphp/php-cs-fixer: ^3.91
- phpstan/extension-installer: ^1.4
- phpstan/phpstan: ^2.1
- phpstan/phpstan-doctrine: ^2.0
- phpstan/phpstan-symfony: ^2.0
- phpunit/phpunit: ^12.4
- roave/security-advisories: dev-latest
- symfony/browser-kit: 7.4.*
- symfony/css-selector: 7.4.*
- symfony/debug-bundle: 7.4.*
- symfony/maker-bundle: ^1.0
- symfony/phpunit-bridge: 7.4.*
- symfony/stopwatch: 7.4.*
- symfony/web-profiler-bundle: 7.4.*
Suggests
None
Provides
None
Conflicts
- dev-master
- 2.x-dev
- v2.1.0
- v2.0.2
- v2.0.1
- v2.0.0
- 1.x-dev
- v1.8.2
- v1.8.1
- v1.8.0
- v1.7.1
- v1.7.0
- v1.6.3
- v1.6.2
- v1.6.0
- v1.5.1
- v1.4.0
- v1.3.2
- 0.x-dev
- v0.2
- v0.1
- dev-chore/add-trim-forms
- dev-fix-backport-revert-site-url
- dev-fix/revert-site-url
- dev-chore/add-phpstan-plugins
- dev-feature/switch-to-symfony-7.4-tls
- dev-feature/remove-acl-bundle
- dev-feature/replace-fos-router
- dev-feature/remove-fos-user-bundle
This package is auto-updated.
Last update: 2026-11-21 17:45:32 UTC
README
BestWishes is a multilingual wishlist application allowing users to manage their wishlist and indicate who have bought what to avoid receiving the same gift for Christmas (for example).
Users can also add surprise gifts and manage additions and purchase alerts.
Recurrent as well as "one-shot" events are also configurable.
Symfony versions support
| Project version | Symfony version |
|---|---|
| 0.x | 5.4 |
| 1.x | 6.4 |
| (current) | 7.4 |
Installation
BestWishes uses Composer to ease the creation of a new project:
$ composer create-project webdl/bestwishes path/to/install
Composer will create a new BestWishes project under the path/to/install directory.
You will have to enter main parameters such as database info and others in the .env file.
Database setup
After having indicated the main parameters, run
$ php bin/console doctrine:database:create
to create the database, and
$ php bin/console doctrine:migrations:migrate
to populate schema.
Application setup
A basic setup command is included, you can use it by running the command:
$ php bin/console bw:setup
This command will create an admin user and defaults events if needed.
PDF exports
BestWishes uses Gotenberg to render printable wishlists with Chromium. Gotenberg runs in its own container. The PHP host only needs HTTP access to it.
When PHP runs on the Docker host, start the Chromium-only image and publish it on localhost.
docker run -d --name bestwishes-gotenberg --restart unless-stopped \ -p 127.0.0.1:3000:3000 \ gotenberg/gotenberg:9.9.1-chromium gotenberg \ --chromium-disable-javascript --chromium-deny-private-ips --chromium-deny-public-ips curl --fail http://127.0.0.1:3000/health
The default GOTENBERG_URL is http://127.0.0.1:3000. Override it in
.env.local or in the environment if you use another address. If PHP also runs
in Docker, replace the -p option with --network <private-network>, using the
network that PHP is on, and set GOTENBERG_URL=http://bestwishes-gotenberg:3000.
Keep the API private because the conversion requests include wishlist content.
Build and deploy the Encore assets with the application. The PDF export sends the compiled CSS and bundled Open Sans and Font Awesome fonts with the rendered HTML.
yarn install --frozen-lockfile yarn build
When upgrading, rebuild the assets and remove the obsolete WKHTMLTOPDF_PATH and
WKHTMLTOIMAGE_PATH settings from any deployment overrides.
Run Gotenberg with Supervisor
When Docker and PHP run on the same host, save this configuration as
/etc/supervisor/conf.d/bestwishes-gotenberg.conf. Keep the command directive
on a single line.
[program:bestwishes-gotenberg] command=/usr/bin/docker run --rm --name bestwishes-gotenberg -p 127.0.0.1:3000:3000 gotenberg/gotenberg:9.9.1-chromium gotenberg --chromium-disable-javascript --chromium-deny-private-ips --chromium-deny-public-ips autostart=true autorestart=true startsecs=3 startretries=5 stopsignal=TERM stopwaitsecs=30 redirect_stderr=true
Supervisor runs the container in the foreground and handles restarts. If you
already launched the standalone container above, stop and remove it first to
free the container name and port. The Supervisor entry uses the default
GOTENBERG_URL of http://127.0.0.1:3000.
Pull the image, activate the entry, and check the process status and HTTP health endpoint.
sudo docker pull gotenberg/gotenberg:9.9.1-chromium sudo supervisorctl reread sudo supervisorctl update sudo supervisorctl status bestwishes-gotenberg curl --fail --retry 5 --retry-connrefused http://127.0.0.1:3000/health