Декларація методів має бути сумісною з батьківськими методами в PHP

Суворі стандарти: Декларація childClass :: customMethod () має бути сумісною з дозволом parentClass :: customMethod ()

Які можливі причини цієї помилки в PHP? Де я можу знайти інформацію про те, що означає бути сумісним ?

childClass::customMethod()має різні аргументи або інший рівень доступу (публічний / приватний / захищений), ніж parentClass::customMethod().

Це повідомлення означає, що існують певні можливі виклики методів, які можуть не працювати під час виконання. Припустимо, у вас є

class A { public function foo($a = 1) {;}}
class B extends A { public function foo($a) {;}}
function bar(A $a) {$a->foo();}

Компілятор лише перевіряє виклик $ a-> foo () на вимоги A :: foo (), який не вимагає параметрів. $ a, однак, може бути об'єктом класу B, якому потрібен параметр, і тому виклик буде невдалим під час виконання.

Однак, це ніколи не може вийти з ладу і не призведе до помилки

class A { public function foo($a) {;}}
class B extends A { public function foo($a = 1) {;}}
function bar(A $a) {$a->foo();}

Тому жоден метод не може мати більш необхідних параметрів, ніж його батьківський метод.

Це ж повідомлення також формується, коли підказки типу не збігаються, але в цьому випадку PHP є ще більш обмежуючим. Це дає помилку:

class A { public function foo(StdClass $a) {;}}
class B extends A { public function foo($a) {;}}

як це робить:

class A { public function foo($a) {;}}
class B extends A { public function foo(StdClass $a) {;}}

Це здається більш обмежуючим, ніж це потрібно, і я припускаю, що це пов'язано з внутрішніми.

Різниці в видимості викликають різну помилку, але з тієї ж основної причини. Жоден метод не може бути менш помітним, ніж його батьківський метод.

якщо ви хочете зберегти форму OOP без вимкнення помилок, ви також можете:

class A
{
    public function foo() {
        ;
    }
}
class B extends A
{
    /*instead of : 
    public function foo($a, $b, $c) {*/
    public function foo() {
        list($a, $b, $c) = func_get_args();
        // ...

    }
}

Просто для розширення цієї помилки в контексті інтерфейсу, якщо ви вводите натяк на параметри функції, як-от так:

інтерфейс A

use Bar;

interface A
{
    public function foo(Bar $b);
}

Клас В

class B implements A
{
    public function foo(Bar $b);
}

Якщо ви забули включити useоператор до свого класу реалізації (клас B), ви також отримаєте цю помилку, навіть якщо параметри методу однакові.

Я зіткнувся з цією проблемою, намагаючись розширити існуючий клас від GitHub. Я спробую пояснити себе, спочатку пишу клас так, як я, як і мабуть, а потім клас, як зараз.

Що я хоч

namespace mycompany\CutreApi;

use mycompany\CutreApi\ClassOfVendor;

class CutreApi extends \vendor\AwesomeApi\AwesomeApi
{
   public function whatever(): ClassOfVendor
   {
        return new ClassOfVendor();
   }
}

Що я нарешті зробив

namespace mycompany\CutreApi;

use \vendor\AwesomeApi\ClassOfVendor;

class CutreApi extends \vendor\AwesomeApi\AwesomeApi
{
   public function whatever(): ClassOfVendor
   {
        return new \mycompany\CutreApi\ClassOfVendor();
   }
}

Так виглядає, що ця помилка виникає також, коли ви використовуєте метод, який повертає клас простору імен, і ви намагаєтесь повернути той же клас, але з іншим простором імен. На щастя, я знайшов це рішення, але я не повністю розумію перевагу цієї функції в php 7.2, для мене нормально переписати існуючі методи класу як потрібні, включаючи переосмислення вхідних параметрів та / або навіть поведінку метод.

Недоліком попереднього підходу є те, що IDE не змогли розпізнати нові методи, реалізовані в \ mycompany \ CutreApi \ ClassOfVendor (). Тож поки що я піду з цією реалізацією.

В даний час зроблено

namespace mycompany\CutreApi;

use mycompany\CutreApi\ClassOfVendor;

class CutreApi extends \vendor\AwesomeApi\AwesomeApi
{
   public function getWhatever(): ClassOfVendor
   {
        return new ClassOfVendor();
   }
}

Отже, замість того, щоб намагатися використовувати метод "що завгодно", я написав новий під назвою "getWever". Насправді вони обидва роблять те саме, просто повертаючи клас, але з просторами імен різних, як я описав раніше.

Сподіваюся, це може комусь допомогти.