Değeri önceden belirlenmiş bir sabit olması beklenen işlev veya yöntem parametrelerini belgelemek için önerilen yol nedir? Şimdiye kadar, sabitin veri türünü kullanıyorum ve daha sonra biraz açıklama yapıyorum.Bir sabit bekleyeceği bir parametre nasıl kaydedilir
Ör: tanımlamak/phpdoc
const kullanarak sabit belgelemek konusunda
<?php
class Foo{
const METHOD_GET = 'get';
const METHOD_POST = 'post';
/**
* Load a new foo
*
* @param string $method HTTP method to use (either Foo::METHOD_GET or Foo::METHOD_POST)
*/
public function load($method=Foo::METHOD_POST){
// ...
}
/**
* Sort current foo
*
* @param int $sort_order Sort order (either SORT_ASC or SORT_DESC)
*/
public function sort($sort_order=SORT_ASC){
// ...
}
}
bana iyi göründü olduğu gibi, muhtemelen iki yöntemi 'post()' ve 'get()' ve sortAsc() ve 'sortDesc()' ye sahip olmak ya da http istek ve sıralama stratejilerini Foo'ya aktarılabilen harici nesneler yapmak isterdim. – Gordon
Bu konuyla ilgili bir tartışma: https://github.com/phpDocumentor/phpDocumentor2/issues/557 – artspb