Witaj Gościu! ( Zaloguj | Rejestruj )

Forum PHP.pl

> phpDocumentor i MVC, dokumentacja dla kontrolera
Xathloc
post
Post #1





Grupa: Zarejestrowani
Postów: 41
Pomógł: 0
Dołączył: 12.09.2006
Skąd: znad klawiatury

Ostrzeżenie: (0%)
-----


Podczas dokumentowania projektow mam niedomiennie ten sam problem. PHPDocumentor generuje z założenia dokumentację dla klas. Kontroler klasą nie jest i co za tym idzie jest ignorowany podczas tworzenia dokumentacji. Dla mnie kontroler, jako element spinający całość, jest najlepszym miejszcem do zawarcia najobszerniejszego opisu.
Jak wy rozwiązujecie problem dokumentacji kontrolera i całości aplikacji/modułu? Czy korzystacie z innych narzędzi?
Jak dla mnie PHPDocumentor jest najwygodniejszy, bo znajduje się w ZDE, którego używam.
Go to the top of the page
+Quote Post
 
Start new topic
Odpowiedzi
dr_bonzo
post
Post #2





Grupa: Przyjaciele php.pl
Postów: 5 724
Pomógł: 259
Dołączył: 13.04.2004
Skąd: N/A

Ostrzeżenie: (0%)
-----


Tzn. masz tego switch'a w glownym pliku, poza jakakolwiej funkcja i chceszgo zdukumentowac?
Tak sie nie da.

Wrzuc to wszystko w jedna klase, a kazda akcje wstaw do osobnej funkcji:

  1. <?php
  2. function dispatch()
  3. {
  4.  
  5. switch()
  6.  { 
  7.  case "costam" : $this->costam();
  8.  case "....
  9. }
  10. }
  11. ?>


// choc i tak przyda sie automatyczne wywolywanie funkcji (IMG:http://forum.php.pl/style_emoticons/default/smile.gif)

No i teraz masz funkcje klasy ktore phpdoc zauwazy.
Go to the top of the page
+Quote Post
Xathloc
post
Post #3





Grupa: Zarejestrowani
Postów: 41
Pomógł: 0
Dołączył: 12.09.2006
Skąd: znad klawiatury

Ostrzeżenie: (0%)
-----


Tak, ale wracamy do punktu wyjścia.
Chyba faktycznie phpDoc zmusi mnie do robienia wszystkiego porządnie i tworzenia klasy kontrolera zamiast kontrolera strukturalnego (IMG:http://forum.php.pl/style_emoticons/default/tongue.gif)
W każdym razie dziękuję wam za pomoc.
I zmuszenie do porzucenia nieprawidłowych nawyków (IMG:http://forum.php.pl/style_emoticons/default/aaevil.gif)
Ale to już w wersji 1.1 tego modułu (IMG:http://forum.php.pl/style_emoticons/default/tongue.gif)
1.0 własnie rusza do Klienta.
Go to the top of the page
+Quote Post

Posty w temacie


Reply to this topicStart new topic
2 Użytkowników czyta ten temat (2 Gości i 0 Anonimowych użytkowników)
0 Zarejestrowanych:

 



RSS Aktualny czas: 15.10.2025 - 18:29