Net
[ class tree: Net ] [ index: Net ] [ all elements ]

Class: Net_IDNA2

Source Location: /Net_IDNA2-0.1.1/Net/IDNA2.php

Class Overview


Encode/decode Internationalized Domain Names.


Author(s):

Version:

  • $Id: IDNA2.php 305344 2010-11-14 23:52:42Z neufeind $

Methods


Inherited Variables

Inherited Methods


Class Details

[line 58]
Encode/decode Internationalized Domain Names.

The class allows to convert internationalized domain names (see RFC 3490 for details) as they can be used with various registries worldwide to be translated between their original (localized) form and their encoded form as it will be used in the DNS (Domain Name System).

The class provides two public methods, encode() and decode(), which do exactly what you would expect them to do. You are allowed to use complete domain names, simple strings and complete email addresses as well. That means, that you might use any of the following notations:

  • www.n�rgler.com
  • xn--nrgler-wxa
  • xn--brse-5qa.xn--knrz-1ra.info
Unicode input might be given as either UTF-8 string, UCS-4 string or UCS-4 array. Unicode output is available in the same formats. You can select your preferred format via set_paramter().

ACE input and output is always expected to be ASCII.



[ Top ]


Method Detail

__construct (Constructor)   [line 2232]

Net_IDNA2 __construct( [array $options = null])

Constructor

Parameters:

array   $options   —  Options to initialise the object with

[ Top ]

decode   [line 2413]

string decode( string $input, [string $one_time_encoding = false])

Decode a given ACE domain name.
  • Return: Decoded Domain name (UTF-8 or UCS-4)
  • Throws: Exception
  • Access: public

Parameters:

string   $input   —  Domain name (ACE string)
string   $one_time_encoding   —  Desired output encoding, see set_parameter

[ Top ]

encode   [line 2325]

string encode( string $decoded, [string $one_time_encoding = false])

Encode a given UTF-8 domain name.
  • Return: Encoded Domain name (ACE string)
  • Throws: Exception
  • Access: public

Parameters:

string   $decoded   —  Domain name (UTF-8 or UCS-4)
string   $one_time_encoding   —  Desired input encoding, see set_parameter If not given will use default-encoding

[ Top ]

getInstance   [line 3368]

Net_IDNA2 getInstance( [array $params = array()])

Attempts to return a concrete IDNA instance for either php4 or php5.
  • Access: public

Parameters:

array   $params   —  Set of paramaters

[ Top ]

setParams   [line 2267]

boolean setParams( mixed $option, [string $value = false])

Sets a new option value. Available options and values:

[utf8 - Use either UTF-8 or ISO-8859-1 as input (true for UTF-8, false otherwise); The output is always UTF-8] [overlong - Unicode does not allow unnecessarily long encodings of chars, to allow this, set this parameter to true, else to false; default is false.] [strict - true: strict mode, good for registration purposes - Causes errors on failures; false: loose mode, ideal for "wildlife" applications by silently ignoring errors and returning the original input instead]

  • Return: true on success, false otherwise
  • Access: public

Parameters:

mixed   $option   —  Parameter to set (string: single parameter; array of Parameter => Value pairs)
string   $value   —  Value to use (if parameter 1 is a string)

[ Top ]

singleton   [line 3385]

object Net_IDNA2 singleton( [array $params = array()])

Attempts to return a concrete IDNA instance for either php4 or php5, only creating a new instance if no IDNA instance with the same parameters currently exists.
  • Access: public

Parameters:

array   $params   —  Set of paramaters

[ Top ]


Documentation generated on Mon, 11 Mar 2019 15:41:59 -0400 by phpDocumentor 1.4.4. PEAR Logo Copyright © PHP Group 2004.