final

src/M/AdModel.php

@@ -29,16 +29,20 @@ class AdModel extends Model{
   protected $table_pdate;
 
   /**
-   * @return mixed
+   * Получить id
+   *
+   * @return integer|null
    */
   public function getId() {
     return (int) $this->table_id;
   }
 
   /**
-   * @param $username
+   * Установить имя пользователя
    *
-   * @return bool|string
+   * @param string $username имя пользавтеля
+   *
+   * @return bool|string true в случае успеха. иначе сообщение с разъяснениями
    */
   public function setUserName( $username ) {
     if ( preg_match( '/[a-z,\d]{3,}/i', $username ) ) {
@@ -49,14 +53,21 @@ class AdModel extends Model{
     }
   }
 
+  /**
+   * Получить имя пользователя
+   *
+   * @return string
+   */
   public function getUserName(){
     return $this->table_username;
   }
 
   /**
-   * @param mixed $email
+   * Установка e-mail
    *
-   * @return bool|string
+   * @param string $email
+   *
+   * @return bool|string true в случае успеха. иначе сообщение с разъяснениями
    */
   public function setEmail( $email ) {
     if ( preg_match('/.+@.+\..+/i', $email ) ) {
@@ -68,6 +79,8 @@ class AdModel extends Model{
   }
 
   /**
+   * Получить e-mail
+   *
    * @return mixed
    */
   public function getEmail() {
@@ -75,9 +88,11 @@ class AdModel extends Model{
   }
 
   /**
-   * @param mixed $homepage
+   * Установка домашней страницы
    *
-   * @return bool|string
+   * @param string $homepage URL
+   *
+   * @return bool|string true в случае успеха. иначе сообщение с разъяснениями
    */
   public function setHomepage( $homepage ) {
     if ( preg_match('|https?://.*\..*|i', $homepage ) ) {
@@ -89,6 +104,8 @@ class AdModel extends Model{
   }
 
   /**
+   * Получение домашней страницы
+   *
    * @return mixed
    */
   public function getHomepage() {
@@ -96,6 +113,8 @@ class AdModel extends Model{
   }
 
   /**
+   * Установка IP адреса
+   *
    * @param mixed $ip
    */
   public function setIp( $ip ) {
@@ -103,6 +122,8 @@ class AdModel extends Model{
   }
 
   /**
+   * Получение IP адреса
+   *
    * @return mixed
    */
   public function getIp() {
@@ -110,6 +131,8 @@ class AdModel extends Model{
   }
 
   /**
+   * Установка данных User-Agent
+   *
    * @param mixed $browser
    */
   public function setBrowser( $browser ) {
@@ -117,6 +140,8 @@ class AdModel extends Model{
   }
 
   /**
+   * Получение данных User-Agent
+   *
    * @return mixed
    */
   public function getBrowser() {
@@ -124,6 +149,8 @@ class AdModel extends Model{
   }
 
   /**
+   * Установка текста
+   *
    * @param mixed $text
    */
   public function setText( $text ) {
@@ -131,6 +158,8 @@ class AdModel extends Model{
   }
 
   /**
+   * Получение текста
+   *
    * @return mixed
    */
   public function getText() {
@@ -138,6 +167,8 @@ class AdModel extends Model{
   }
 
   /**
+   * Установка даты
+   *
    * @param mixed $date
    */
   public function setDate( $date ) {
@@ -145,20 +176,28 @@ class AdModel extends Model{
   }
 
   /**
+   * Получение даты
    * @return mixed
    */
   public function getDate() {
     return $this->table_pdate;
   }
 
+  /**
+   * Получение количества страниц
+   *
+   * @return int
+   */
   public function countPages() {
-    return ceil($this->count()/25);
+    return (int) ceil($this->count()/25);
   }
 
   /**
-   * @param int $page_number
-   * @param string $sort_by
-   * @param string $order
+   * Получение массива объектов для вывода на страницах
+   *
+   * @param integer $page_number номер страницы
+   * @param string $sort_by сортировка по столбцу
+   * @param string $order сортировка по возрастанию или убыванию
    *
    * @return mixed
    */

src/M/CAPTCHAModel.php

@@ -11,10 +11,22 @@ namespace PTEST\M;
 
 class CAPTCHAModel {
 
+  /**
+   * Проверка даных капчи
+   *
+   * @param string $code
+   *
+   * @return bool|string
+   */
   public function verify( $code ) {
     return strtoupper( $code ) == $_SESSION['CAPTCHA'] ? true : "Неверный код с картинки";
   }
 
+  /**
+   * Генерирование изображения
+   *
+   * @return string
+   */
   public function getImage() {
     global $app;
     $letters = 'ABDEFABDEFGKLMNPRSTWXYZ482GKLMNABDEFGKLMNPRSTWXYZ482PRSTWXYZ482'; // алфавит