Решение именованных параметров в PHP 7+ - PullRequest
Новая
       35

Решение именованных параметров в PHP 7+

1 голос
/ 02 июня 2019

Как я могу реализовать функцию именованного аргумента в PHP 7 +?

Идеальный синтаксис: 

find($wildcard, relative = true, listIfEmpty = false) {
    ...
}

Но такого решения не существует.В ответ я реализовал самое короткое из возможных решений, которое поддерживает:

  • Рефакторинг
  • Тип Подсказки для параметров и результата функции
  • Набор параметров многократного использования
  • Typesafe params
  • Значения по умолчанию для параметров
  • Получатель для каждого параметра (без жестко запрограммированной строки)
  • Очень простой установщик / получатель, который необходимо изменить только одним именемдля каждого параметра

См. ответ для получения дополнительной информации и реализации

1 Ответ

1 голос
/ 02 июня 2019

Сделайте это один в вашей структуре или глобально: 

// the superclass that every params class will extend this
class params {
  protected function setter($key, $value) {
    if ($value === null) {
      return $this->{$key};
    }

    $this->{$key} = $value;
    return $this;
  }
}

Сделайте это для каждой функции, которой требуются именованные аргументы с именами: 

// define a helper method for simple instantiation
function params_find() { return new params_find(); }

// a params class that will use from find() method
class params_find extends params {

  // list of params with default values
  // below list is just a sample
  protected $listIfEmpty   = false;
  protected $structured    = true;
  protected $relative      = false;
  protected $prefix        = "";
  protected $justFileNames = false;

  // for each param duplicate line and just change function name exactly matching param name. setter/getter will done automatically
  function listIfEmpty($val = null)   { return $this->setter(__FUNCTION__, $val); }
  function structured($val = null)    { return $this->setter(__FUNCTION__, $val); }
  function relative($val = null)      { return $this->setter(__FUNCTION__, $val); }
  function prefix($val = null)        { return $this->setter(__FUNCTION__, $val); }
  function justFileNames($val = null) { return $this->setter(__FUNCTION__, $val); }
}

Напишите вашу функцию, используя эту функцию: 

// your function that uses named arguments
// in this example $wildcard argument is required
function find($wildcard = [], params_find $opt = null) {
  if ($opt === null) {
    $opt = params_find();
  }

  // do something with your params like this
  if ($opt->structured()) {
    // ...
  }

  return $something_if_you_want;
}

Наконец, используйте его с самым простым интерфейсом: 

// finally use your function with some params ( other params will have default values )
$files = find("*.css", params_find()
  ->structured(false)
  ->listIfEmpty(true)
  ->prefix("something")
);


// if you need all default values
$files = find("*.css");


// reusable options
$opt = params_find()
  ->listIfEmpty(false)
  ->prefix("something")
)
$files1 = find("*.css", $opt);
$files2 = find("*.html", $opt);
$files3 = find("*.scss", $opt
  ->structured(true)
);
...