2012-02-04 3 views
1

추상 메소드에 대한 메소드 문서화를 가능하게 할 수 있습니까? 예 :추상 클래스의 PHP 메소드 문서화

<?php 
abstract class Math{ 
    /** 
    * Method that receive two values and return the result of some operation. 
    * @param $a Number 
    * @param $b Number 
    */ 
    abstract public function values($a, $b); 
} 
?> 

<?php 
class Sum extends Math{ 
    /** 
    * @return $a+$b; 
    */ 
    public function values($a, $b){ 
     return $a+$b; 
    } 
} 
?> 

<?php 
class Divide extends Math{ 
    /** 
    * @return $a/$b; 
    * @throws Exception. 
    */ 
    public function values($a, $b){ 
     if($b != 0){ 
      return $a/$b; 
     }else{ 
      throw new Exception("Impossible to divide by 0."); 
     } 
    } 
} 
?> 

가 어떻게 함께 방법에 대한 모든 정보를 넣을까요? 현재 Netbeans 7.1에서 작업하고 있습니다. IDE 문제입니까? 아니면 이것이 작동하는 방식이 아닌가?

<?php 
// Estabele conexão com o MySQL 
$connect = mysql_connect('localhost', 'root', '123456') or die('A conexão falhou.'); 
// Seleciona o banco de dados 
$database = mysql_select_db('monografia', $connect) or die('Falha ao tentar selecionar banco de dados.'); 

if ($database) 
    echo 'Conectado atraves do driver nativo.'; 

?> 

<br /> 

<?php 
class Conexao { 
    protected $conexao; 
    public function Conexao() { 
     $this->conexao = new MySQLi('localhost', 'root', '123456', 'monografia', 3306); 
     if (!$this->conexao->connect_error) 
      echo 'Conectado atraves da extensao MySQLi.'; 
    } 
} 
new Conexao(); 

?> 

<br /> 

<?php 
class ConexaoPDO { 
    protected $pdo;  
    public function ConexaoPDO() { 
     try { 
      $this->pdo = new PDO('mysql:host=localhost:3306;dbname=monografia', 'root', '123456', array(PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION)); 
      echo 'Conectado atraves do PDO.'; 
     } catch(PDOException $e) { 
      echo $e->getMessage(); 
     } 
    } 
} 

new ConexaoPDO(); 
?> 

답변

0

@inheritDoc 태그를 살펴 보시기 바랍니다.

1

사용중인 tool/ide/plug-in에만 해당됩니다. 일반적인 관행에 관한 한, 나는 상속 된 문서를 본 적이 없다. 어떤 경우 든, 각 클래스에 대해 전체 문서를 넣거나, 상속되거나, 추상화되거나, 다른 방법으로 다른 사람이 코드를 읽는 것이 얼마나 명확한 지 생각해보십시오.

+0

나는 그것을 생각했다. 나도 게으름 뱅이가 아니기 때문에 문서를 실제로 복사 할 필요없이 파일을 복사/붙여 넣기하지 않았는지 확인하고 싶었습니다. 가능한 경우 아프지 않습니다. 감사. –