lord-server.ru

Official website of Russian L.O.R.D. server for Minetest

• Local Deploy
• Usage in development
  • Everyday up & down
  • Code Style Check & Fix
  • Control Code Quality
• About Laravel

Local deploy

• Clone the project

  git clone git@gitlab.com:ava-it-group/investments/web-application.git

• Step inside & copy your own .env:

  cd web-application
  cp .env.example .env

• Then you need to install dependencies inside the sail container via composer

  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

• Now we need to up the containers and generate secret key for our application:

  vendor/bin/sail up -d
  vendor/bin/sail artisan key:generate

• For use the latest frontend install dependencies & build it:

  vendor/bin/sail npm install
  vendor/bin/sail npm run build

• That's all folks! You can find the app at:
  http://0.0.0.0/

Usage in development

• Everyday up & down
• Code Style Check & Fix
• Control Code Quality

Everyday up & down

Backend:

• For the up containers use:
  • vendor/bin/sail up - to see the logs
  • or vendor/bin/sail up -d - to execute in background
• If you up containers in background use
  • vendor/bin/sail down - to stop them

    Frontend:

• For just build the latest version (for ex. after switch between branches or pul new commits):

  ./vendor/bin/sail npm install
  ./vendor/bin/sail npm run build

• For frontend developing & get changes on the fly:
  • vendor/bin/sail npm run dev

For quick start use ./dev command instead.

Code Style Check & Fix

We use PHP-CS-Fixer for control Code Style. Package php-cs-fixer installed locally in the project, so you can check style with:

• if you have php installed locally:
  • vendor/bin/php-cs-fixer check --diff - for just check
  • or ./vendor/bin/php-cs-fixer fix - if you trust this tool :)
• or the same commands inside container:
  • vendor/bin/sail php vendor/bin/php-cs-fixer check --diff
  • vendor/bin/sail php vendor/bin/php-cs-fixer fix

For more use --help & documentation.
You can enable support for your IDE. It will alert you to problems on the fly.

Control Code Quality

We use PHPStan for code quality control. Package phpstan installed locally in the project, so just:

• vendor/bin/phpstan analyse or
• vendor/bin/sail php vendor/bin/phpstan analyse

Also see the Documentation.
Config for all developers we store in phpstan.neon.dist. Also, it's used in CI.
If you want to add some your own settings (for ex. for your IDE), create phpstan.neon with similar lines:

includes:
  - phpstan.neon.dist

parameters:
  editorUrl: 'phpstorm://open?file=%%file%%&line=%%line%%'

See examples in docs: Output Format.
Also look at helpful extensions.

About Laravel

Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as:

• Simple, fast routing engine.
• Powerful dependency injection container.
• Multiple back-ends for session and cache storage.
• Expressive, intuitive database ORM.
• Database agnostic schema migrations.
• Robust background job processing.
• Real-time event broadcasting.

Laravel is accessible, powerful, and provides tools required for large, robust applications.

Learning Laravel

Laravel has the most extensive and thorough documentation and video tutorial library of all modern web application frameworks, making it a breeze to get started with the framework.

You may also try the Laravel Bootcamp, where you will be guided through building a modern Laravel application from scratch.

If you don't feel like reading, Laracasts can help. Laracasts contains thousands of video tutorials on a range of topics including Laravel, modern PHP, unit testing, and JavaScript. Boost your skills by digging into our comprehensive video library.