This is a documentation for Board Game Arena: play board games online !

Плаyерс ацтионс: yоургаменаме.ацтион.пхп

Извор: Board Game Arena
Пређи на навигацију Пређи на претрагу

Пурпосе оф тхис филе

Wитх тхис филе, yоу дефине алл тхе плаyерс ентрy поинтс (ие: поссибле гаме ацтионс) оф yоур гаме.

Тхис филе ис а сорт оф "бридге" бетwеен тхе АЈАX цаллс yоу аре доинг фром yоур Јавасцрипт цлиент сиде, анд yоур маин ПХП цоде ин "yоургаме.гаме.пхп".

Тхе роле оф тхе метходс дефинед ин тхис филе ис то филтер тхе аргументс, евентуаллy то формат тхем а литтле бит, анд тхен то цалл а цорреспондинг ПХП метход фром yоур маин гаме логиц ("yоургаме.гаме.пхп" филе).

Метходс ин тхис филе муст бе схорт: но гаме логиц муст бе интродуцед хере.

Еxампле оф тyпицал ацтион метход

(фром Реверси еxампле)

    public function playDisc()
    {
        self::setAjaxMode();     
        $x = self::getArg( "x", AT_posint, true );
        $y = self::getArg( "y", AT_posint, true );
        $result = $this->game->playDisc( $x, $y );
        self::ajaxResponse( );
    }

Метходс то усе ин ацтион метходс

фунцтион сетАјаxМоде
Муст бе усе ат тхе бегиннинг оф еацх ацтион метход.
фунцтион ајаxРеспонсе
Муст бе усе ат тхе енд оф еацх ацтион метход.
фунцтион гетАрг( $аргНаме, $аргТyпе, $мандаторy=фалсе, $дефаулт=НУЛЛ, $аргТyпеДетаилс=арраy(), $бЦанФаил=фалсе )
Тхис метход муст бе усед то ретриеве тхе аргументс сент wитх yоур АЈАX qуерy.
Yоу муст НОТ усе "_ГЕТ", "_ПОСТ" ор еqуивалент ПХП вариаблес то до тхис, ас ит ис унсафе.
Тхис метход усе тхе фоллоwинг аргументс:
* аргНаме: тхе наме оф тхе аргумент то ретриеве.
* аргТyпе: тхе тyпе оф тхе аргумент. Yоу схоулд усе оне оф тхе фоллоwинг:
'АТ_инт' фор ан интегер
'АТ_посинт' фор а поситиве интегер
'АТ_флоат' фор а флоат
'АТ_боол' фор 1/0/труе/фалсе
'АТ_енум' фор ан енумератион (аргТyпеДетаилс лист тхе поссибле валуес ас ан арраy)
'АТ_алпханум' фор а стринг wитх 0-9а-зА-З_ анд спаце


бЦанФаил меанс тхан а валидатион фаилуре ис поссибле (усер инпут)
Тхе маин аргТyпе валуес аре ас фоллоwс.


; function isArg( $argName )
: Return "true" or "false" whether "argName" has been specified as an argument of the AJAX request or not.