Witam, tak jak w temacie

czy lepiej jest napisać:

[PHP] pobierz, plaintext 
public function update($_query = '', $_values = array())
[PHP] pobierz, plaintext 

żeby podać od razu, że query to string, a values to array

czy lepiej po prostu

[PHP] pobierz, plaintext 
public function update($_query, $_values)
[PHP] pobierz, plaintext 

?

No i najważniejsze: Dlaczego wg. Ciebie tak, a nie inaczej?

Lepiej rzutować typy

[PHP] pobierz, plaintext 
public function update($_query, array $_values=array()) {
 
       if(!is_string($_query)) {
             throw new XYZ_Exception('query musi byc stringiem);
       }
}
[PHP] pobierz, plaintext 

wtedy masz pewność, że parametry są takiego typu jaki oczekujesz

np.

[PHP] pobierz, plaintext 
public function update(\Obiekt\Interface $obiekt, array $array) {}
 
$this->update('aha', 'oho');
[PHP] pobierz, plaintext 

Dzięki temu, że PHP wprowadził type hinting
Można mniej więcej doprowadzić w tym języku do wymuszonego silnego typowania - ale to raczej sztuka dla sztuki

Odpowiadając na twoje pytanie:

Nie ma to jakiegokolwiek znaczenia

Poza tym, implementując taki kod jak pokazałeś nie sądzę, abyś był zadowolony z faktu, że twoją metodę będzie można wykonać bez parametrów (gdyż obu nadałeś domyślną wartość)

[PHP] pobierz, plaintext 
$object->update();
[PHP] pobierz, plaintext 

PHP jest językiem słabo-typowanym, więc nawet jeżeli podasz mu tą domyślną wartość jako string.
To mu to nie przeszkodzi, aby upchnąć tam np arraya lub integera, bez żadnego błędu.

Przypisywanie domyślnych wartości służy tylko do definiowania opcjonalnych danych
Takich, które mogą zostać podane (aby przykładowo rozwinąć funkcjonalność danej metody lub zmienić trochę jej dotychczasowe działanie), ale nie muszą

Jeżeli zależy ci na tym, aby kontrolować to co znalazło się w metodzie jako parametr to musisz sobie samemu tworzyć obsługę silnego typowania rzucając przykładowo wyjątek gdy parametr posiada inny typ niż się spodziewasz - tak jak pokazał poprzednik.

Jeżeli korzystasz z przekazywania obiektów między metodami, możesz korzystać z mechanizmu type-hintingu, który wymusza, aby parametr był instancja podanej klasy - to również pokazał poprzednik

Array jest dosyć fajnym typem, bo jednocześnie jest nazwą typu (array) oraz możemy używać array w type hintingu bez zbędnego kombinowania i wtedy mamy pewność, że parametr będzie tablicą, bo w przeciwnym wypadku PHP rzuci fatal error - to także pokazał ci mój poprzednik.


Zagłębiając się w genezę to PHP najprawdopodobniej zapożyczył swój type hinting z Javy, gdzie jest on używany na porządku dziennym:


Podobnie jest zresztą w C#, tylko że zarówno w nim jak i w javie (języki obiektowe, silno-typowane), możemy korzystać z type hintingu do oznaczania wszystkich typów np. (int, string), gdyż tam są one obiektami.

Natomiast w PHP int oraz string, są zwykłymi typami prostymi, inaczej zwanymi typami skalarnymi (z stąd także nazwa funkcji is_scalar), przez co nie można ich użyć w zaimplementowanym type hintingu, o czym informuje nas dokumentacja.


Type hinting w php jest domyślnie dozwolony tylko dla tablic oraz obiektów - są to typy złożone

Jeżeli jesteś zainteresowany tym tematem to możesz sobie poczytać o przykładowej implementacji silnego typowania PHP
(Sztuka dla sztuki, ale temat bardzo ciekawy - bardziej w celach teoretycznych niż praktycznych)

http://php.webtutor.pl/pl/2011/03/23/silne...-w-php-czesc-i/
http://php.webtutor.pl/pl/2011/04/12/silne...czalne-obiekty/

Ale wracając do głównego tematu:

Być może chodzi ci o to, aby poinformować drugiego programistę o tym, czego ta metoda się spodziewa
Aby to zrobić możesz użyć bloków PHPDoc i atrybutów/tagów @param

Przykładowo:

[PHP] pobierz, plaintext 
/**
 * @access  public
 * @param   string   $value  Value to validate
 * @param   RuleInterface   $rule   Validation rule
 * @return  boolean True or false
 */
public function validate($value, RuleInterface $rule)
{
    // doing something
}
[PHP] pobierz, plaintext 

W sumie chyba źle napisałem w swoim pierwszym poście, a miałem właśnie na myśli żeby podać do funkcji tylko dane konkretnego typu. Tak jak pisałeś np. array $_values -> mówi o tym, że zmienna $_values musi być typu array.

O dokumentowaniu kodu też wiem, ale to już inna sprawa.

Najpierw należy się zapoznać czym są parametry wymagane, a opcjonalne, bo z wymuszaniem typu to nie ma nic wspólnego.

Opcjonalny to taki jaki pokazałem w pierwszym poście czyli

[PHP] pobierz, plaintext 
function ($wymagany, $opcjonalny = null) { }
[PHP] pobierz, plaintext 

W powyższym przypadku musimy podać $wymagany, a $opcjonalny mimo wszystko przyjmuje null.

Czym jest parametr wymagany? Czy to jest to, co podałem powyżej określając, który parametr ma wartość domyślną (jest opcjonalny) czy jeszcze coś innego?

Tak, te parametry co podałeś to rzeczywiście kolejno wymagany i opcjonalny, ale mi raczej chodziło o to, żeby się zapoznać jakie jest znaczenie takich parametrów i dlaczego chcieć za pomocą parametrów opcjonalnych podpowiadać typy danych to raczej zabawna rzecz. Poziomowo to jest coś z serii "Czy nie mogę po prostu w każdej klasie jaką robię zadeklarowac wszystkich właściwości i metod jako statycznych i ich tak używać" ?