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инг:
 'AT_int' for an integer
 'AT_posint' for a positive integer 
 'AT_float' for a float
 'AT_bool' for 1/0/true/false
 'AT_enum' for an enumeration (argTypeDetails list the possible values as an array)
 'AT_alphanum' for a string with 0-9a-zA-Z_ and space
 'AT_numberlist' for a list of several numbers separated with "," or ";" (ex: exemple: 1,4;2,3;-1,2).


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


фунцтион исАрг( $аргНаме )

Ретурн "труе" ор "фалсе" wхетхер "аргНаме" хас беен специфиед ас ан аргумент оф тхе АЈАX реqуест ор нот.