Как бы вы выполнили это задание из учебника?

Question

[Август Милович]

Здраствуйте! Учу php по учебнику, после каждой главы задание, и вот задание, в котором я очень не уверен:

Создайте класс с методом find (), принимающий единственный аргумент - ­строку с названием функции РНР. В качестве результата метод должен возвра­щать текст с сайта php.net с описанием функции.

Как я понял, если я ищу какую-то функцию, то там один и тот же адрес с названием искомой функции посередине, и должно быть всё легко. То есть есть такая ссылка https://www.php.net/manual/ru/function.(unlink).php, и есть такая https://www.php.net/manual/ru/function.(delete).php, меняется одно слово. Но есть ли более универсальное решение, или это делается так? Просто я долго думал, пытаясь применить все свои знания из учебника, получается только так, но ощущение, что есть какое-то более хорошее решение, которое я не могу найти. Об уровне моих знаний, основы синтаксиса, немного работы с файлами, открыть закрыть положить вытащить и всё. Если кому интересно, кто знает может, Кузнецов, Симдянов Самоучитель PHP 7 (2018) (я на 16 главе). Вобщем, как бы вы решили эту задачу? И заранее спасибо)

Answer 1

[profesor08]

По простому

class Finder {
  public static function find($func) {
    return file_get_contents("https://www.php.net/manual/ru/function.{$func}.php");
  }
}

По интересному, можно воспользоваться поиском на самом сайте, и использовать его механизм. Там ссылка вида https://www.php.net/search.php?show=quickref&patte...

file_get_contents("https://www.php.net/search.php?show=quickref&pattern={$func}");

Можешь еще интереснее, собирать ссылку самостоятельно, например

class Finder {
  public static function find($func) {
    $url = "https://www.php.net/search.php";

    return file_get_contents($url . http_build_query([
      "show" => "quickref",
      "pattern" => $func
    ]));
  }
}

Answer 2

[АртемЪ]

Вобщем, как бы вы решили эту задачу?

Элементарно - приняли на вход название функции, сделали запрос к локальной базе данных хранящей тексты с описанием функций с сайта php.net, выдали результат.
Это гораздо быстрее и эффективнее чем делать каждый раз запрос к стороннему ресурсу, и парсить текст оттуда.

Comments

[Август Милович]

Это мне что, надо себе все описания себе скопировать?

[АртемЪ]

Ну да, зато это будет работать даже при недоступности сайта php.net, работоспособность решения не будет зависеть от внешних факторов, появится возможность масштабирования нагрузки.
И главное - это полностью удовлетворяет условиям задачи.

Хотя если взглянуть с другой стороны можно отыскать у этого решения множество минусов.

Поймите простую вещь - идеальных решений не бывает. Бывают адекватные решения для данной конкретной ситуации.
Хорошее решение хорошо в одной ситуации и совсем неприемлемо в другой.

Поэтому когда вы выполняете просто тестовую задачу - делайте как вы считаете нужным.
Если вы делаете реальную задачу - делайте четко по ТЗ.
Если вдруго нет четкого ТЗ - требуется вникать в ситуацию и четко понимать какое решение для этой ситуации будет лучшим.