Новичок в ООП PHP, нужна критика в первом классе Geo RSS

Question

Я совершенно новичок в ООП PHP и сейчас читаю "Объекты PHP, Шаблоны и Практика". Мне нужно было разработать что-то, что будет генерировать канал GeoRSS. Это то, что у меня есть (это работает отлично, я просто хотел бы получить некоторую критику относительно того, что я мог бы сделать по-другому / более эффективно / безопаснее):

class RSS {
 public $channel_title;
 public $channel_description;
 public $channel_link;
 public $channel_copyright;
 public $channel_lang;
 public $item_count;
 public function __construct ($channel_title, $channel_description, $channel_link, $channel_copyright, $channel_lang) {
  $this->channel_title = $channel_title;
  $this->channel_description = $channel_description;
  $this->channel_link = $channel_link;
  $this->channel_copyright = $channel_copyright;
  $this->channel_lang = $channel_lang;
  $this->items = "";
  $this->item_count = 0;
    }
 public function setItem ($item_pubDate, $item_title, $item_link, $item_description, $item_geolat, $item_geolong) {
  $this->items[$this->item_count]['pubDate'] = date("D, j M Y H:i:s T",$item_pubDate);
  $this->items[$this->item_count]['title'] = $item_title;
  $this->items[$this->item_count]['link'] = $item_link;
  $this->items[$this->item_count]['description'] = $item_description;
  $this->items[$this->item_count]['geo:lat'] = $item_geolat;
  $this->items[$this->item_count]['geo:long'] = $item_geolong;
  $this->items[$this->item_count]['georss:point'] = $item_geolat." ".$item_geolong;
  $this->item_count++;
 }
 public function getFeed () {
  foreach ($this->items as $item => $item_element) {
   $items .= "    <item>\n";
   foreach ($item_element as $element => $value) {
    $items .= "      <$element>$value</$element>\n";
   }
   $items .= "    </item>\n";
  }
  $feed = "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n"
    . "<rss version=\"2.0\" xmlns:geo=\"http://www.w3.org/2003/01/geo/wgs84_pos#\" xmlns:georss=\"http://www.georss.org/georss\">\n"
    . "  <channel>\n"
    . "    <title>".$this->channel_title."</title>\n"
    . "    <description>".$this->channel_description."</description>\n"
    . "    <link>".$this->channel_link."</link>\n"
    . "    <copyright>Copyright ".date("Y")." ".$this->channel_copyright.". All rights reserved.</copyright>\n"
    . "    <lang>".$this->channel_lang."</lang>\n"
    . $items
    . "  </channel>\n"
    . "</rss>";
  return $feed;
 }
}

Answer 1

1. Свойства всегда должны быть protected если нет веских причин, чтобы сделать их public или же private,
2. Объявите или инициируйте все переменные перед их использованием: protected $items в теле класса и $items = '' в getFeed,
3. Инициируйте переменные правильно: $this->items = array(); в __construct,

4. Не управляй своим item_count, Лучше полагаться на собственные средства добавления массивов в PHP:

   $this->items[] = array(
       'pubDate'      => date("D, j M Y H:i:s T",$item_pubDate),
       'title'        => $item_title,
       'link'         => $item_link,
       'description'  => $item_description,
       'geo:lat'      => $item_geolat,
       'geo:long'     => $item_geolong,
       'georss:point' => $item_geolat." ".$item_geolong,
   );
   

   Намного лучше, не правда ли?

5. Не объявляйте больше переменных, чем вам нужно:

   foreach ($this->items as $item) {
       $items .= "    <item>\n";
       foreach ($item as $element => $value) {
            $items .= "      <$element>$value</$element>\n";
       }
       $items .= "    </item>\n";
   }
   

   Здесь вам не нужен ключ массива. Так что не бери это в foreach цикл;) Вместо этого используйте $item для значения, которое лучше, чем $item_element,

Answer 2

Единственное беспокойство, которое я имею с этим классом, в вашем setItem функция, вы должны просто использовать [] обозначение, чтобы выдвинуть ассоциативный массив, как это:

 public function setItem ($item_pubDate, $item_title, $item_link, $item_description, $item_geolat, $item_geolong) {
  $this->items[] = array(
                         'pubDate' => date("D, j M Y H:i:s T",$item_pubDate),
                         'title' => $item_title,
                         'link' => $item_link,
                         'description' => $item_description,
                         'geo:lat' => $item_geolat,
                         'geo:long' => $item_geolong,
                         'georss:point' => $item_geolat.' '.$item_geolong);
 }

Таким образом, вы можете бросить свой $item_count индексная переменная.

Кроме того, пусть ваши свойства будут public обычно очень плохая идея.

Answer 3

Вот несколько моментов:

1. Почему все участники публичны? Вы устанавливаете их в конструкторе, а затем используете их для создания канала. Поэтому, вероятно, не стоит позволять кому-либо менять их по своему желанию. Разве они не должны быть окончательными / неизменными для каждого экземпляра?
2. Ваши предметы должны быть, вероятно, отдельным классом. Всякий раз, когда вы видите, что вы создаете большой ассоциативный массив, как у вас там в setItem, это означает, что у вас есть другой объект в игре. Так сделай class RSSItem или что-то подобное, с этими вещами в качестве членов.

Если я подумаю больше, я отредактирую свой ответ.

Answer 4

Выглядит хорошо для первого таймера! Где вы обрабатываете данные, которые вы отправляете в качестве параметров? Лично я обработал бы все с помощью методов класса, цель объектов состоит в том, чтобы содержать объекты. Это означает, что вся связанная с ними обработка должна происходить внутри самого класса.

Кроме того, возможно, это хорошая идея, чтобы поиграть с наследованием и публичными, частными членами, классами, которые используют другие классы, как предложил Tesserex. Тем не менее, хорошее начало на ООП там.