Manuel Pear

Net_NNTP::prepareConnection()

Net_NNTP::prepareConnection() -- connects to a newsgroup on a newsserver

Synopsis

  1. <?php
  2. require_once 'Net/NNTP.php
  3. ?> 

boolean Net_NNTP::prepareConnection (string $nntpserver [, integer $port = 119, integer $newsgroup [, integer $user = NULL [, integer $pass = NULL, integer [$authmode = PEAR_NNTP_ORIGINAL]]]])

Description

Connect to a specific newsserver and access the given newsgroup

Avertissement

Cette fonction est obsolète. Cela signifie qu'elle pourra ne plus être supportée dans les prochaines versions du module.

Consider this method deprecated - use Net_NNTP::connectAuthenticated() instead.

Paramètres

  • $nntpserver - Name of the newsserver to connect

  • $port - Port, where the newsserver listens

  • $newsgroup - Newsgroup to access

  • $user - Username to authenticate

  • $user - Username to authenticate

  • $pass - Password to authenticate

  • $authmode - Type of authentication, at the moment only PEAR_NNTP_AUTHORIGINAL

Valeur retournée

boolean - TRUE if successful

Valeurs renvoyées

Tableau 54-1. Valeurs PEAR_Error possibles

Error code Error message Reason Solution
NULL "Could not connect to NNTP-server $nntpserver" or "Not connected" The connection couldn't be established because
  • wrong server name or adress

  • the host itself isn't link to a network

  • a firewall doesn't allow an access

Check for server name, the connection to the net and possible firewalls on client or server side
NULL Every other message This message is directly passed from the news server, in the most cases caused by calling a non existing newsgroup Check the given newsgroup name

Note

Cette fonction ne peut pas être appelée de façon statique.

Avertissement

Cette fonction est obsolète. Cela signifie qu'elle pourra ne plus être supportée dans les prochaines versions du module.

Fetching data with a connection created with prepareConnection() is faster then a created connection with connect()

Exemple

Exemple 54-1. Using prepareConnection()

  1. <?php
  2. require_once "Net/NNTP.php";  
  3.  
  4. $nntp = new Net_NNTP;  
  5. $ret = $nntp->connect("news.php.net", 119, "php.pear.dev");  
  6. if( PEAR::isError($ret)) {  
  7. // handle error
  8. } else {  
  9. // success
  10. ?> 

Remonter Remonter
L'éditeur javascript - CSS - Gentoo - Tutoriaux PHP - Tutoriels PHP - Bretagne - php - Moto - Kit graphique