Education program

1. Greetings
2. Pre-requirements
3. Workflow
4. Special Notes
5. See also

Hello, my name is Lyavon. I'm Professor Cat and founder of the EduCat Academy for Gifted Youngsters.

This platform acts as an educational and training ground for cultivating Youngsters IT-powers.

I was created with love by Dzianis Kotau - PHP Evangelist and Yana Barantsava - Coolest Designer.

All tasks in the course are self-crafted and licenced as intellectual property. If you find these tasks somewhere else, please inform Dzianis Kotau.

1. It's highly recommended to use Ubuntu latest stable edition.
2. Install php 8.1 following instructions for your OS.
3. Install and enable at least php-xml extension.
4. Install Composer tool.
   • If you are using GNU/Linux, run as the last Composer installation step:

   mv composer.phar /usr/local/bin/composer
   chmod a+x /usr/local/bin/composer

5. Optional steps if you don't yet have public/private keys for your GitHub account:
   • Generate public/private keys for Github. You can use ssh-keygen command with parameters on GNU/Linux (press Enter for any prompt):

   ssh-keygen -t ecdsa -b 521 -C "educat_key" -f ~/.ssh/github_educat

   • Create ~/.ssh/config file with following instructions:

   # GitHub.com
   Host github.com
   UpdateHostKeys no
   PreferredAuthentications publickey
   IdentityFile ~/.ssh/github_educat
   

   • Copy ssh public key to your GitHub profile.
6. Identify yourself for GitHub:

git config --global user.name "Your Name"
git config --global user.email "your_email"

1. You will be granted access to the repository with tasks.
2. Clone the repository to your machine.
3. Subscribe to the repository to be able to receive any notification on it.
4. Create separate branch and folder in src/ and tests/ for each task.
5. When you are ready to show your solution (task and tests), create Pull Request (PR).
6. If you have errors reported by GitHub Actions, check their details and fix issues.

1. See Task1 source and test files as example.

2. Use PSR-12 and PSR-4 for code styling, autoload, etc.

3. Use English for comments, class, properties, methods, functions, etc.

4. If you use files without class declaration, add your src file to lib/includes.php file to be able to run tests.

5. Before creating PR run in your machine following commands

   • composer style to check code style
   • composer analyse to perform static analyse
   • composer tests to run tests
   • composer validate --strict to validate your composer config files

6. Create PR only after all above commands run with green (success) return status.

1. PHP Documentation
2. PHP: The Right Way
3. Laracasts
4. SymfonyCasts
5. Laravel Daily
6. PHP Point
7. Composer
8. Git Book