This repository contains the source code for the official HBO-ICT IT-Conference.
Since the application uses Docker, the development environment must be in Linux for optimal performance and compatibility with Laravel Sail; either use native Linux or use WSL. Installing a Linux distribution also will be needed - the most used one during the development process was Ubuntu, but it is still a personal preference. NPM/Node should also be present on the distro as of this version.
Since Laravel Sail takes on most of the configuration and installation of the project, the following steps need to be taken in order to install.
docker run --rm \
-u "$(id -u):$(id -g)" \
-v "$(pwd):/var/www/html" \
-w /var/www/html \
laravelsail/php83-composer:latest \
composer install --ignore-platform-reqs
npm install
cp .env.example .env
./vendor/bin/sail artisan key:generate
./vendor/bin/sail up -d
./vendor/bin/sail artisan migrate
npm run dev
This issue may be encountered after installing the application and trying to access it through the browser. It can be something along the lines of:
The stream or file "/var/www/html/storage/logs/laravel.log" could not be opened in append mode: Failed to open stream: Permission denied
In order to fix this run chmod -R 777 storage bootstrap/cache
. This issue might even occur when the artisan commands are used via sail. If that occurs, try granting only the permissions only to the specified directories.
Instead of using every time ./vendor/bin/sail
this can be shorten by using an alias - alias sail='[ -f sail ] && sh sail || sh vendor/bin/sail'
. This way the commands will shorten (e.g. sail up -d
)
GitHub Actions will trigger a workflow when you push your code to the repository, which will run the tests automatically.
On a local machine, you may run ./vendor/bin/sail phpunit
. If you get a large amount of errors, check whether the
application key has been set successfully, and that either npm run build
or npm run dev
have been run.
When the decision has been made to deploy the application to a server, the instructions can be found here.
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
We use the following format for versioning: YYYY.R.B
YYYY is the year of the release, so 2024.
R represents the release within a year, so if it is the first it would be 1, if it is the second it would be 2.
B represents bugfixes.
See also the list of contributors who participated in this project.
The code in this repository is licenced MIT. All creative works (photos and videos) on the website itself are copyrighted by HBO-ICT unless otherwise stated. Please contact us at kard0004@hz.nl if you would like to use our work.