Что это за загадочные вещи в определении методов?
Возвращаясь к разработке, проведя несколько лет на руководящей должности, я имею дело с PHP-кодом, в котором есть некоторые определения, которые я не могу понять (похоже, я намного превосходил достижения PHP за эти годы). Может кто-нибудь дать мне знать, что в этом определении делают campaignDTO и ParamDTO?
Что будет возвращено из этого метода?
/**
* Creates a campaign
* @param campaignDTO $campaign
* @param ParamDTO $param
* @throws \Exception
* @return campaignDTO
*/
public function createCampaign(campaignDTO $campaign, ParamDTO $param)
{
}
Решение
Объявления типов в соответствии с документами:
Объявления типов позволяют функциям требовать, чтобы параметры имели
определенный тип во время разговора. Если данное значение неверно
типа, то генерируется ошибка: в PHP 5 это будет восстанавливаемым
фатальная ошибка, в то время как PHP 7 сгенерирует исключение TypeError.
Другие решения
Это type-hints для проверки во время выполнения. Это говорит коду ожидать объекты класса campaignDTO а также ParamDTOили класс, который выходит из них.
Если вы передаете массив, или строку, или что-то, что не является классом, который является или расширяется capaignDTO тогда код выдаст ошибку.
Функция, как она есть, ничего не возвращает.
Согласно коду-комментарию, он вернет объект типа campaignDTO, который выглядит как первый параметр.
detector