Align exercises from python

Dockerfile

@@ -1,6 +1,6 @@
 FROM hexletbasics/base-image
 
-ARG PHP_VERSION=8.4
+ARG PHP_VERSION=8.5
 
 WORKDIR /exercises-php
 

composer.json

@@ -17,9 +17,9 @@
     }
   ],
   "autoload": {
-    "files": [
-      "src/Functions.php"
-    ]
+    "psr-4": {
+      "HexletBasics\\Exercise\\": "src/"
+    }
   },
   "require-dev": {
     "friendsofphp/php-cs-fixer": "^3.0",

modules/10-basics/10-hello-world/SolutionTest.php

@@ -2,16 +2,13 @@
 
 namespace HexletBasics\Basics\HelloWorld;
 
-use PHPUnit\Framework\TestCase;
-
-\HexletBasics\Functions\runScript();
+use HexletBasics\Exercise\TestCase;
 
 class SolutionTest extends TestCase
 {
     public function test()
     {
         $expected = 'Hello, World!';
         $this->expectOutputString($expected);
-        require 'index.php';
     }
 }

modules/10-basics/10-hello-world/ru/README.md

@@ -1,42 +1,85 @@
-В этом уроке мы сразу напишем первую программу. Мы узнаем, какие команды понадобятся для этого и какие теги нужно использовать, чтобы программа, которая выполняет код, восприняла его. Также узнаем, зачем в коде нужны комментарии.
+Изучение нового языка программирования традиционно начинается с программы 'Hello, World!'. Это простая программа, которая выводит приветствие на экран и знакомит с синтаксисом и структурой нового языка.
 
-## Как написать простую программу
+```text
+Hello, World!
+```
+
+![Hello World](./assets/hello-world.png)
 
-Чтобы написать программу и вывести результат на экран, используют два способа:
+Этой традиции уже больше сорока лет, и мы тоже начнем с нее. В первом уроке мы напишем программу `Hello, World!`. На PHP эта программа выглядит так:
 
-* Через команду `echo`
-* Через команду `print_r()`
+```php
+<?php
 
-Разберем каждую подробнее.
+print_r('Hello, World!');
+```
 
-### Пишем программу через `echo`
+Строка `<?php` в начале — специальный тег, который сообщает, что дальше идет код на PHP. Подробнее о нем мы поговорим в следующем уроке.
 
-Напишем программу «Hello, World!». Она будет выводить на экран текст:
+Команда `print_r()` выводит на экран текст, указанный в скобках. В конце ставится точка с запятой `;` — так в PHP завершается каждая команда. Вместо примера можно написать любой другой текст.
 
 ```php
 <?php
 
-echo 'Hello, World!';
-// => Hello, World!
+print_r('Хекслет - школа программирования');
 ```
 
+Команда остается той же, меняется только содержимое скобок. Чтобы программа понимала, что это именно текст, он заключается в кавычки. Можно использовать одинарные `'...'` или двойные `"..."`, но открывающая и закрывающая кавычки должны совпадать.
 
-Вывод на экран выполняется с помощью специальной команды `echo`. После нее в одиночных кавычках указывается строка для вывода. В конце обязательно ставим точку с запятой.
+```php
+<?php
+
+print_r("Хекслет - школа программирования");
+```
 
-Для удобства мы будем показывать результат запуска строк кода так: `=> РЕЗУЛЬТАТ`.
+В PHP принято использовать одинарные кавычки для строк. Если внутри строки есть апостроф, одинарные кавычки сломают синтаксис, поэтому в таких случаях используют двойные.
 
-### Пишем программу через `print_r()`
+```php
+<?php
+
+print_r("it's PHP"); // апостроф внутри, поэтому двойные кавычки
+```
 
-Другой способ вывести строку на экран — функция `print_r()`:
+## Способы вывода на экран
+
+Кроме `print_r()`, в PHP есть еще одна команда вывода — `echo`:
 
 ```php
 <?php
 
-print_r('Hello, World!');
+echo 'Hello, World!';
 // => Hello, World!
 ```
 
+Для удобства мы будем показывать результат запуска строк кода так: `// => РЕЗУЛЬТАТ`.
+
+В простых ситуациях между `echo` и `print_r()` нет разницы — можно использовать любую команду. А там, где на экран нужно выводить не просто числа или строки, а, например, массивы, `echo` не сможет этого сделать, а `print_r()` все выведет.
 
-В этом случае строка указывается в скобках сразу после имени функции. В конце также нужно ставить `;`.
+## Значение символов
+
+Код состоит из команд, и каждая из них должна быть написана в определенной форме. Помимо букв, в коде важны кавычки `'` и `"`, скобки `()` и знаки препинания. Пропущенный или перепутанный знак приведет к тому, что программа не запустится. Попробуйте определить, какая ошибка допущена в каждой из строк?
+
+```php
+<?php
 
-В простых ситуациях между этими конструкциями нет разницы. Можно использовать любой способ. А там, где на экран нужно выводить не просто числа или строки, а, например, массивы, `echo` не сможет этого сделать, а `print_r()` все выведет.
+print_r("it's PHP"
+print_r(it's PHP")
+prin_r("it's PHP")
+print_r('it's PHP")
+print_r["it's PHP"];
+```
+
+Даже небольшое отличие, например одна лишняя буква или другой знак, может привести к тому, что программа не будет работать. Это относится и к регистру, то есть к различию между большими и маленькими буквами. Если в обычном тексте `Привет` и `привет` выглядят одинаково, то для программы это разные тексты. Имена функций PHP прощают разный регистр, но имена переменных и многие другие конструкции, с которыми мы встретимся дальше, — нет. Поэтому надежнее всего набирать код в точности так, как в примерах.
+
+## Где практиковаться
+
+Теория усваивается лучше, когда параллельно запускаешь код и видишь результат. Для этого подходит онлайн-интерпретатор PHP, где код выполняется прямо в браузере. Все, что встречается в уроке, стоит пробовать [в онлайн-интерпретаторе PHP](https://3v4l.org/).
+
+Как это работает технически? Любой написанный код передается в интерпретатор PHP, который этот код выполняет и выводит на экран результат его работы.
+
+```text
+Код               Интерпретатор        Экран
+┌────────────┐     ┌─────────────┐     ┌──────────────┐
+│ print_r(…) │ ──→ │     PHP     │ ──→ │ Hello, World!│
+└────────────┘     └─────────────┘     └──────────────┘
+```

modules/10-basics/10-hello-world/ru/data.yml

@@ -3,4 +3,4 @@ name: Привет, Мир!
 tips:
   - >
     [Немного о 'Hello,
-    World!'](https://ru.hexlet.io/blog/posts/moy-chelovek-menya-ponimaet-istoriya-frazy-hello-world-i-ee-analogov)
+    World!'](https://ru.hexlet.io/blog/posts/moy-chelovek-menya-ponimaet-istoriya-frazy-hello-world-i-ee-analogov?utm_source=code-basics&utm_medium=referral&utm_campaign=blog&utm_content=lesson)

modules/10-basics/20-tags/SolutionTest.php → modules/10-basics/15-tags/SolutionTest.php

@@ -2,16 +2,13 @@
 
 namespace HexletBasics\Basics\Tags;
 
-use PHPUnit\Framework\TestCase;
-
-\HexletBasics\Functions\runScript();
+use HexletBasics\Exercise\TestCase;
 
 class SolutionTest extends TestCase
 {
     public function test()
     {
         $expected = 'King in the North!';
         $this->expectOutputString($expected);
-        require 'index.php';
     }
 }

modules/10-basics/20-comments/Solution.php

@@ -0,0 +1,3 @@
+<?php
+
+// TODO: добавить функцию приветствия

modules/10-basics/20-comments/SolutionTest.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace HexletBasics\Basics\Comments;
+
+use HexletBasics\Exercise\TestCase;
+
+class SolutionTest extends TestCase
+{
+    public function test()
+    {
+        $this->expectOutputString('');
+        $content = file_get_contents('Solution.php');
+        $this->assertStringContainsString('// TODO: добавить функцию приветствия', $content);
+    }
+}

modules/10-basics/20-comments/ru/EXERCISE.md

@@ -0,0 +1,9 @@
+Вы пишете программу и понимаете, что одну часть нужно доделать позже. Чтобы не забыть, программисты оставляют себе заметки прямо в коде — TODO-комментарии.
+
+Добавьте в файл такой комментарий:
+
+```php
+// TODO: добавить функцию приветствия
+```
+
+Когда вернётесь к этому месту позже, комментарий напомнит, что здесь ещё есть незавершённая работа.

modules/10-basics/20-comments/ru/README.md

@@ -0,0 +1,77 @@
+Кроме самого кода, в исходных файлах часто можно встретить комментарии. Это строки, которые интерпретатор не обрабатывает. Программисты пишут их, чтобы пояснить, как работает код, отметить ошибки или напомнить, что нужно доделать.
+
+```php
+<?php
+
+// Удалить строку ниже после реализации задачи по регистрации
+print_r(10);
+```
+
+Однострочные комментарии в PHP начинаются с символов `//` или `#`, после которых может идти любой текст. Все, что написано после них до конца строки, интерпретатор игнорирует.
+
+```text
+// комментарий      ──→  [ пропущено интерпретатором ]
+print_r('hello');   ──→  [ выполнено → hello ]
+// еще один         ──→  [ пропущено интерпретатором ]
+```
+
+Комментарий может занимать всю строку:
+
+```php
+<?php
+
+// For Winterfell!
+// For Lanisters!
+```
+
+Или стоять в конце строки с кодом:
+
+```php
+<?php
+
+print_r('I am the King'); // For Lannisters!
+```
+
+Если нужно оставить длинное пояснение, используют несколько строк с `//`:
+
+```php
+<?php
+
+// The night is dark and
+// full of terrors.
+print_r('I am the King');
+```
+
+Для таких случаев в PHP есть и специальный вид — многострочные комментарии. Они начинаются с `/*` и заканчиваются на `*/`, а каждую строку между ними принято начинать с символа `*`:
+
+```php
+<?php
+
+/*
+ * The night is dark and
+ * full of terrors.
+ */
+print_r('I am the King');
+```
+
+Интерпретатор игнорирует комментарии. Разработчики благодаря им быстрее разбираются в чужом коде и не забывают важные детали в собственном.
+
+## Служебные комментарии
+
+В процессе работы вы будете встречаться с таким кодом в нашем редакторе:
+
+```php
+// BEGIN
+
+// END
+```
+
+*BEGIN* и *END* здесь это обычные комментарии, которые никак не влияют на работу программы. Они показывают, куда писать код задания.
+
+```php
+// BEGIN
+<здесь ваше решение>
+// END
+```
+
+Увидев *BEGIN* и *END*, пишите свой код между ними, остальное оставляйте без изменений.

modules/10-basics/30-comments/ru/data.yml → modules/10-basics/20-comments/ru/data.yml

@@ -1,6 +1,9 @@
 ---
 name: Комментарии
-tips: []
+tips:
+  - >
+    [Подробнее о
+    комментариях](https://www.w3schools.com/php/php_comments.asp)
 definitions:
   - name: Комментарий
     description: >

modules/10-basics/40-instructions/SolutionTest.php → modules/10-basics/30-instructions/SolutionTest.php

@@ -2,16 +2,13 @@
 
 namespace HexletBasics\Basics\Instructions;
 
-use PHPUnit\Framework\TestCase;
-
-\HexletBasics\Functions\runScript();
+use HexletBasics\Exercise\TestCase;
 
 class SolutionTest extends TestCase
 {
     public function test()
     {
         $expected = 'RobertStannisRenly';
         $this->expectOutputString($expected);
-        require 'index.php';
     }
 }