lib/validateurlsyntax.php

   1 <?php
   2
   3 // This file is part of Moodle - http://moodle.org/
   4 //
   5 // Moodle is free software: you can redistribute it and/or modify
   6 // it under the terms of the GNU General Public License as published by
   7 // the Free Software Foundation, either version 3 of the License, or
   8 // (at your option) any later version.
   9 //
  10 // Moodle is distributed in the hope that it will be useful,
  11 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 // GNU General Public License for more details.
  14 //
  15 // You should have received a copy of the GNU General Public License
  16 // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
  17
  18 /**
  19  * About validateUrlSyntax():
  20  * This function will verify if a http URL is formatted properly, returning
  21  * either with true or false.
  22  *
  23  * I used rfc #2396 URI: Generic Syntax as my guide when creating the
  24  * regular expression. For all the details see the comments below.
  25  *
  26  * Usage:
  27  *     validateUrlSyntax( url_to_check[, options])
  28  *
  29  *     url_to_check - string - The url to check
  30  *
  31  *     options - string - A optional string of options to set which parts of
  32  *          the url are required, optional, or not allowed. Each option
  33  *          must be followed by a "+" for required, "?" for optional, or
  34  *          "-" for not allowed.
  35  *
  36  *          s - Scheme. Allows "+?-", defaults to "s?"
  37  *              H - http:// Allows "+?-", defaults to "H?"
  38  *              S - https:// (SSL). Allows "+?-", defaults to "S?"
  39  *              E - mailto: (email). Allows "+?-", defaults to "E-"
  40  *              F - ftp:// Allows "+?-", defaults to "F-"
  41  *                  Dependant on scheme being enabled
  42  *          u - User section. Allows "+?-", defaults to "u?"
  43  *              P - Password in user section. Allows "+?-", defaults to "P?"
  44  *                  Dependant on user section being enabled
  45  *          a - Address (ip or domain). Allows "+?-", defaults to "a+"
  46  *              I - Ip address. Allows "+?-", defaults to "I?"
  47  *                  If I+, then domains are disabled
  48  *                  If I-, then domains are required
  49  *                  Dependant on address being enabled
  50  *          p - Port number. Allows "+?-", defaults to "p?"
  51  *          f - File path. Allows "+?-", defaults to "f?"
  52  *          q - Query section. Allows "+?-", defaults to "q?"
  53  *          r - Fragment (anchor). Allows "+?-", defaults to "r?"
  54  *
  55  *  Paste the funtion code, or include_once() this template at the top of the page
  56  *  you wish to use this function.
  57  *
  58  *
  59  * Examples:
  60  * <code>
  61  *  validateUrlSyntax('http://george@www.cnn.com/#top')
  62  *
  63  *  validateUrlSyntax('https://games.yahoo.com:8080/board/chess.htm?move=true')
  64  *
  65  *  validateUrlSyntax('http://www.hotmail.com/', 's+u-I-p-q-r-')
  66  *
  67  *  validateUrlSyntax('/directory/file.php#top', 's-u-a-p-f+')
  68  *
  69  *
  70  *  if (validateUrlSyntax('http://www.canowhoopass.com/', 'u-'))
  71  *  {
  72  *      echo 'URL SYNTAX IS VERIFIED';
  73  *  } else {
  74  *      echo 'URL SYNTAX IS ILLEGAL';
  75  *  }
  76  * </code>
  77  *
  78  * Last Edited:
  79  *  December 15th 2004
  80  *
  81  *
  82  * Changelog:
  83  *  December 15th 2004
  84  *    -Added new TLD's - .jobs, .mobi, .post and .travel. They are official, but not yet active.
  85  *
  86  *  August 31th 2004
  87  *    -Fixed bug allowing empty username even when it was required
  88  *    -Changed and added a few options to add extra schemes
  89  *    -Added mailto: ftp:// and http:// options
  90  *    -https option was 'l' now it is 'S' (capital)
  91  *    -Added password option. Now passwords can be disabled while usernames are ok (for email)
  92  *    -IP Address option was 'i' now it is 'I' (capital)
  93  *    -Options are now case sensitive
  94  *    -Added validateEmailSyntax() and validateFtpSyntax() functions below<br>
  95  *
  96  *  August 27th, 2004
  97  *    -IP group range is more specific. Used to allow 0-299. Now it is 0-255
  98  *    -Port range more specific. Used to allow 0-69999. Now it is 0-65535<br>
  99  *    -Fixed bug disallowing 'i-' option.<br>
 100  *    -Changed license to GPL
 101  *
 102  *  July 8th, 2004
 103  *    -Fixed bug disallowing 'l-' option. Thanks Dr. Cheap
 104  *
 105  *  June 15, 2004
 106  *    -Added options parameter to make it easier for people to plug the function in
 107  *     without needed to rework the code.
 108  *    -Split the example application away from the function
 109  *
 110  *  June 1, 2004
 111  *    -Complete rewrite
 112  *    -Now more modular
 113  *      -Easier to disable sections
 114  *      -Easier to port to other languages
 115  *      -Easier to port to verify email addresses
 116  *    -Uses only simple regular expressions so it is more portable
 117  *    -Follows RFC closer for domain names. Some "play" domains may break
 118  *    -Renamed from 'verifyUrl()' to 'validateUrlSyntax()'
 119  *    -Removed extra code which added 'http://' and trailing '/' if it was missing
 120  *      -That code was better suited for a massaging function, not verifying
 121  *    -Bug fixes:
 122  *      -Now splits up and forces '/path?query#fragment' order
 123  *      -No longer requires a path when using a query or fragment
 124  *
 125  *  August 29, 2003
 126  *    -Allowed port numbers above 9999. Now allows up to 69999
 127  *
 128  *  Sometime, 2002
 129  *    -Added new top level domains
 130  *      -aero, coop, museum, name, info, biz, pro
 131  *
 132  *  October 5, 2000
 133  *    -First Version
 134  *
 135  *
 136  * Intentional Limitations:
 137  *  -Does not verify url actually exists. Only validates the syntax
 138  *  -Strictly follows the RFC standards. Some urls exist in the wild which will
 139  *   not validate. Including ones with square brackets in the query section '[]'
 140  *
 141  *
 142  * Known Problems:
 143  *  -None at this time
 144  *
 145  *
 146  * Author(s):
 147  *  Rod Apeldoorn - rod(at)canowhoopass(dot)com
 148  *
 149  *
 150  * Homepage:
 151  *  http://www.canowhoopass.com/
 152  *
 153  *
 154  * Thanks!:
 155  *  -WEAV -Several members of Weav helped to test - http://weav.bc.ca/
 156  *  -There were also a number of emails from other developers expressing
 157  *   thanks and suggestions. It is nice to be appreciated. Thanks!
 158  *
 159  * Alternate Commercial Licenses:
 160  * For information in regards to alternate licensing, contact me.
 161  *
 162  * @package moodlecore
 163  * @copyright Copyright 2004, Rod Apeldoorn {@link http://www.canowhoopass.com/}
 164  * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 165  */
 166
 167 /**
 168  *  BEGINNING OF validateUrlSyntax() function
 169  */
 170 function validateUrlSyntax( $urladdr, $options="" ){
 171
 172     // Force Options parameter to be lower case
 173     // DISABLED PERMAMENTLY - OK to remove from code
 174     //    $options = strtolower($options);
 175
 176     // Check Options Parameter
 177     if (!preg_match( '/^([sHSEFuPaIpfqr][+?-])*$/', $options ))
 178     {
 179         trigger_error("Options attribute malformed", E_USER_ERROR);
 180     }
 181
 182     // Set Options Array, set defaults if options are not specified
 183     // Scheme
 184     if (strpos( $options, 's') === false) $aOptions['s'] = '?';
 185     else $aOptions['s'] = substr( $options, strpos( $options, 's') + 1, 1);
 186     // http://
 187     if (strpos( $options, 'H') === false) $aOptions['H'] = '?';
 188     else $aOptions['H'] = substr( $options, strpos( $options, 'H') + 1, 1);
 189     // https:// (SSL)
 190     if (strpos( $options, 'S') === false) $aOptions['S'] = '?';
 191     else $aOptions['S'] = substr( $options, strpos( $options, 'S') + 1, 1);
 192     // mailto: (email)
 193     if (strpos( $options, 'E') === false) $aOptions['E'] = '-';
 194     else $aOptions['E'] = substr( $options, strpos( $options, 'E') + 1, 1);
 195     // ftp://
 196     if (strpos( $options, 'F') === false) $aOptions['F'] = '-';
 197     else $aOptions['F'] = substr( $options, strpos( $options, 'F') + 1, 1);
 198     // User section
 199     if (strpos( $options, 'u') === false) $aOptions['u'] = '?';
 200     else $aOptions['u'] = substr( $options, strpos( $options, 'u') + 1, 1);
 201     // Password in user section
 202     if (strpos( $options, 'P') === false) $aOptions['P'] = '?';
 203     else $aOptions['P'] = substr( $options, strpos( $options, 'P') + 1, 1);
 204     // Address Section
 205     if (strpos( $options, 'a') === false) $aOptions['a'] = '+';
 206     else $aOptions['a'] = substr( $options, strpos( $options, 'a') + 1, 1);
 207     // IP Address in address section
 208     if (strpos( $options, 'I') === false) $aOptions['I'] = '?';
 209     else $aOptions['I'] = substr( $options, strpos( $options, 'I') + 1, 1);
 210     // Port number
 211     if (strpos( $options, 'p') === false) $aOptions['p'] = '?';
 212     else $aOptions['p'] = substr( $options, strpos( $options, 'p') + 1, 1);
 213     // File Path
 214     if (strpos( $options, 'f') === false) $aOptions['f'] = '?';
 215     else $aOptions['f'] = substr( $options, strpos( $options, 'f') + 1, 1);
 216     // Query Section
 217     if (strpos( $options, 'q') === false) $aOptions['q'] = '?';
 218     else $aOptions['q'] = substr( $options, strpos( $options, 'q') + 1, 1);
 219     // Fragment (Anchor)
 220     if (strpos( $options, 'r') === false) $aOptions['r'] = '?';
 221     else $aOptions['r'] = substr( $options, strpos( $options, 'r') + 1, 1);
 222
 223
 224     // Loop through options array, to search for and replace "-" to "{0}" and "+" to ""
 225     foreach($aOptions as $key => $value)
 226     {
 227         if ($value == '-')
 228         {
 229             $aOptions[$key] = '{0}';
 230         }
 231         if ($value == '+')
 232         {
 233             $aOptions[$key] = '';
 234         }
 235     }
 236
 237     // DEBUGGING - Unescape following line to display to screen current option values
 238     // echo '<pre>'; print_r($aOptions); echo '</pre>';
 239
 240
 241     // Preset Allowed Characters
 242     $alphanum    = '[a-zA-Z0-9]';  // Alpha Numeric
 243     $unreserved  = '[a-zA-Z0-9_.!~*' . '\'' . '()-]';
 244     $escaped     = '(%[0-9a-fA-F]{2})'; // Escape sequence - In Hex - %6d would be a 'm'
 245     $reserved    = '[;/?:@&=+$,]'; // Special characters in the URI
 246
 247     // Beginning Regular Expression
 248                        // Scheme - Allows for 'http://', 'https://', 'mailto:', or 'ftp://'
 249     $scheme            = '(';
 250     if     ($aOptions['H'] === '') { $scheme .= 'http://'; }
 251     elseif ($aOptions['S'] === '') { $scheme .= 'https://'; }
 252     elseif ($aOptions['E'] === '') { $scheme .= 'mailto:'; }
 253     elseif ($aOptions['F'] === '') { $scheme .= 'ftp://'; }
 254     else
 255     {
 256         if ($aOptions['H'] === '?') { $scheme .= '|(http://)'; }
 257         if ($aOptions['S'] === '?') { $scheme .= '|(https://)'; }
 258         if ($aOptions['E'] === '?') { $scheme .= '|(mailto:)'; }
 259         if ($aOptions['F'] === '?') { $scheme .= '|(ftp://)'; }
 260         $scheme = str_replace('(|', '(', $scheme); // fix first pipe
 261     }
 262     $scheme            .= ')' . $aOptions['s'];
 263     // End setting scheme
 264
 265                        // User Info - Allows for 'username@' or 'username:password@'. Note: contrary to rfc, I removed ':' from username section, allowing it only in password.
 266                        //   /---------------- Username -----------------------\  /-------------------------------- Password ------------------------------\
 267     $userinfo          = '((' . $unreserved . '|' . $escaped . '|[;&=+$,]' . ')+(:(' . $unreserved . '|' . $escaped . '|[;:&=+$,]' . ')+)' . $aOptions['P'] . '@)' . $aOptions['u'];
 268
 269                        // IP ADDRESS - Allows 0.0.0.0 to 255.255.255.255
 270     $ipaddress         = '((((2(([0-4][0-9])|(5[0-5])))|([01]?[0-9]?[0-9]))\.){3}((2(([0-4][0-9])|(5[0-5])))|([01]?[0-9]?[0-9])))';
 271
 272                        // Tertiary Domain(s) - Optional - Multi - Although some sites may use other characters, the RFC says tertiary domains have the same naming restrictions as second level domains
 273     $domain_tertiary   = '(' . $alphanum . '(([a-zA-Z0-9-]{0,62})' . $alphanum . ')?\.)*';
 274
 275 /* MDL-9295 - take out domain_secondary here and below, so that URLs like http://localhost/ and lan addresses like http://host/ are accepted.
 276                        // Second Level Domain - Required - First and last characters must be Alpha-numeric. Hyphens are allowed inside.
 277     $domain_secondary  = '(' . $alphanum . '(([a-zA-Z0-9-]{0,62})' . $alphanum . ')?\.)';
 278 */
 279
 280 // we want more relaxed URLs in Moodle: MDL-11462
 281                        // Top Level Domain - First character must be Alpha. Last character must be AlphaNumeric. Hyphens are allowed inside.
 282     $domain_toplevel   = '([a-zA-Z](([a-zA-Z0-9-]*)[a-zA-Z0-9])?)';
 283 /*                       // Top Level Domain - Required - Domain List Current As Of December 2004. Use above escaped line to be forgiving of possible future TLD's
 284     $domain_toplevel   = '(aero|biz|com|coop|edu|gov|info|int|jobs|mil|mobi|museum|name|net|org|post|pro|travel|ac|ad|ae|af|ag|ai|al|am|an|ao|aq|ar|as|at|au|aw|az|ax|ba|bb|bd|be|bf|bg|bh|bi|bj|bm|bn|bo|br|bs|bt|bv|bw|by|bz|ca|cc|cd|cf|cg|ch|ci|ck|cl|cm|cn|co|cr|cs|cu|cv|cx|cy|cz|de|dj|dk|dm|do|dz|ec|ee|eg|eh|er|es|et|eu|fi|fj|fk|fm|fo|fr|ga|gb|gd|ge|gf|gg|gh|gi|gl|gm|gn|gp|gq|gr|gs|gt|gu|gw|gy|hk|hm|hn|hr|ht|hu|id|ie|il|im|in|io|iq|ir|is|it|je|jm|jo|jp|ke|kg|kh|ki|km|kn|kp|kr|kw|ky|kz|la|lb|lc|li|lk|lr|ls|lt|lu|lv|ly|ma|mc|md|mg|mh|mk|ml|mm|mn|mo|mp|mq|mr|ms|mt|mu|mv|mw|mx|my|mz|na|nc|ne|nf|ng|ni|nl|no|np|nr|nu|nz|om|pa|pe|pf|pg|ph|pk|pl|pm|pn|pr|ps|pt|pw|py|qa|re|ro|ru|rw|sa|sb|sc|sd|se|sg|sh|si|sj|sk|sl|sm|sn|so|sr|st|sv|sy|sz|tc|td|tf|tg|th|tj|tk|tl|tm|tn|to|tp|tr|tt|tv|tw|tz|ua|ug|uk|um|us|uy|uz|va|vc|ve|vg|vi|vn|vu|wf|ws|ye|yt|yu|za|zm|zw)';
 285 */
 286
 287                        // Address can be IP address or Domain
 288     if ($aOptions['I'] === '{0}') {       // IP Address Not Allowed
 289         $address       = '(' . $domain_tertiary . /* MDL-9295 $domain_secondary . */ $domain_toplevel . ')';
 290     } elseif ($aOptions['I'] === '') {  // IP Address Required
 291         $address       = '(' . $ipaddress . ')';
 292     } else {                            // IP Address Optional
 293         $address       = '((' . $ipaddress . ')|(' . $domain_tertiary . /* MDL-9295 $domain_secondary . */ $domain_toplevel . '))';
 294     }
 295     $address = $address . $aOptions['a'];
 296
 297                        // Port Number - :80 or :8080 or :65534 Allows range of :0 to :65535
 298                        //    (0-59999)         |(60000-64999)   |(65000-65499)    |(65500-65529)  |(65530-65535)
 299     $port_number       = '(:(([0-5]?[0-9]{1,4})|(6[0-4][0-9]{3})|(65[0-4][0-9]{2})|(655[0-2][0-9])|(6553[0-5])))' . $aOptions['p'];
 300
 301                        // Path - Can be as simple as '/' or have multiple folders and filenames
 302     $path              = '(/((;)?(' . $unreserved . '|' . $escaped . '|' . '[:@&=+$,]' . ')+(/)?)*)' . $aOptions['f'];
 303
 304                        // Query Section - Accepts ?var1=value1&var2=value2 or ?2393,1221 and much more
 305     $querystring       = '(\?(' . $reserved . '|' . $unreserved . '|' . $escaped . ')*)' . $aOptions['q'];
 306
 307                        // Fragment Section - Accepts anchors such as #top
 308     $fragment          = '(\#(' . $reserved . '|' . $unreserved . '|' . $escaped . ')*)' . $aOptions['r'];
 309
 310
 311     // Building Regular Expression
 312     $regexp = '#^' . $scheme . $userinfo . $address . $port_number . $path . $querystring . $fragment . '$#i';
 313
 314     // DEBUGGING - Uncomment Line Below To Display The Regular Expression Built
 315     // echo '<pre>' . htmlentities(wordwrap($regexp,70,"\n",1)) . '</pre>';
 316
 317     // Running the regular expression
 318     if (preg_match( $regexp, $urladdr ))
 319     {
 320         return true; // The domain passed
 321     }
 322     else
 323     {
 324         return false; // The domain didn't pass the expression
 325     }
 326
 327 } // END Function validateUrlSyntax()
 328
 329
 330
 331 /**
 332  * About ValidateEmailSyntax():
 333  * This function uses the ValidateUrlSyntax() function to easily check the
 334  * syntax of an email address. It accepts the same options as ValidateURLSyntax
 335  * but defaults them for email addresses.
 336  *
 337  *
 338  * Usage:
 339  * <code>
 340  *  validateEmailSyntax( url_to_check[, options])
 341  * </code>
 342  *  url_to_check - string - The url to check
 343  *
 344  *  options - string - A optional string of options to set which parts of
 345  *          the url are required, optional, or not allowed. Each option
 346  *          must be followed by a "+" for required, "?" for optional, or
 347  *          "-" for not allowed. See ValidateUrlSyntax() docs for option list.
 348  *
 349  *  The default options are changed to:
 350  *      s-H-S-E+F-u+P-a+I-p-f-q-r-
 351  *
 352  *  This only allows an address of "name@domain".
 353  *
 354  * Examples:
 355  * <code>
 356  *  validateEmailSyntax('george@fakemail.com')
 357  *  validateEmailSyntax('mailto:george@fakemail.com', 's+')
 358  *  validateEmailSyntax('george@fakemail.com?subject=Hi%20George', 'q?')
 359  *  validateEmailSyntax('george@212.198.33.12', 'I?')
 360  * </code>
 361  *
 362  *
 363  * Author(s):
 364  *  Rod Apeldoorn - rod(at)canowhoopass(dot)com
 365  *
 366  *
 367  * Homepage:
 368  *  http://www.canowhoopass.com/
 369  *
 370  *
 371  * License:
 372  *  Copyright 2004 - Rod Apeldoorn
 373  *
 374  *  Released under same license as validateUrlSyntax(). For details, contact me.
 375  */
 376
 377 function validateEmailSyntax( $emailaddr, $options="" ){
 378
 379     // Check Options Parameter
 380     if (!preg_match( '/^([sHSEFuPaIpfqr][+?-])*$/', $options ))
 381     {
 382         trigger_error("Options attribute malformed", E_USER_ERROR);
 383     }
 384
 385     // Set Options Array, set defaults if options are not specified
 386     // Scheme
 387     if (strpos( $options, 's') === false) $aOptions['s'] = '-';
 388     else $aOptions['s'] = substr( $options, strpos( $options, 's') + 1, 1);
 389     // http://
 390     if (strpos( $options, 'H') === false) $aOptions['H'] = '-';
 391     else $aOptions['H'] = substr( $options, strpos( $options, 'H') + 1, 1);
 392     // https:// (SSL)
 393     if (strpos( $options, 'S') === false) $aOptions['S'] = '-';
 394     else $aOptions['S'] = substr( $options, strpos( $options, 'S') + 1, 1);
 395     // mailto: (email)
 396     if (strpos( $options, 'E') === false) $aOptions['E'] = '?';
 397     else $aOptions['E'] = substr( $options, strpos( $options, 'E') + 1, 1);
 398     // ftp://
 399     if (strpos( $options, 'F') === false) $aOptions['F'] = '-';
 400     else $aOptions['F'] = substr( $options, strpos( $options, 'F') + 1, 1);
 401     // User section
 402     if (strpos( $options, 'u') === false) $aOptions['u'] = '+';
 403     else $aOptions['u'] = substr( $options, strpos( $options, 'u') + 1, 1);
 404     // Password in user section
 405     if (strpos( $options, 'P') === false) $aOptions['P'] = '-';
 406     else $aOptions['P'] = substr( $options, strpos( $options, 'P') + 1, 1);
 407     // Address Section
 408     if (strpos( $options, 'a') === false) $aOptions['a'] = '+';
 409     else $aOptions['a'] = substr( $options, strpos( $options, 'a') + 1, 1);
 410     // IP Address in address section
 411     if (strpos( $options, 'I') === false) $aOptions['I'] = '-';
 412     else $aOptions['I'] = substr( $options, strpos( $options, 'I') + 1, 1);
 413     // Port number
 414     if (strpos( $options, 'p') === false) $aOptions['p'] = '-';
 415     else $aOptions['p'] = substr( $options, strpos( $options, 'p') + 1, 1);
 416     // File Path
 417     if (strpos( $options, 'f') === false) $aOptions['f'] = '-';
 418     else $aOptions['f'] = substr( $options, strpos( $options, 'f') + 1, 1);
 419     // Query Section
 420     if (strpos( $options, 'q') === false) $aOptions['q'] = '-';
 421     else $aOptions['q'] = substr( $options, strpos( $options, 'q') + 1, 1);
 422     // Fragment (Anchor)
 423     if (strpos( $options, 'r') === false) $aOptions['r'] = '-';
 424     else $aOptions['r'] = substr( $options, strpos( $options, 'r') + 1, 1);
 425
 426     // Generate options
 427     $newoptions = '';
 428     foreach($aOptions as $key => $value)
 429     {
 430         $newoptions .= $key . $value;
 431     }
 432
 433     // DEBUGGING - Uncomment line below to display generated options
 434     // echo '<pre>' . $newoptions . '</pre>';
 435
 436     // Send to validateUrlSyntax() and return result
 437     return validateUrlSyntax( $emailaddr, $newoptions);
 438
 439 } // END Function validateEmailSyntax()
 440
 441
 442
 443 /**
 444  * About ValidateFtpSyntax():
 445  * This function uses the ValidateUrlSyntax() function to easily check the
 446  * syntax of an FTP address. It accepts the same options as ValidateURLSyntax
 447  * but defaults them for FTP addresses.
 448  *
 449  *
 450  * Usage:
 451  * <code>
 452  *  validateFtpSyntax( url_to_check[, options])
 453  * </code>
 454  *  url_to_check - string - The url to check
 455  *
 456  *  options - string - A optional string of options to set which parts of
 457  *          the url are required, optional, or not allowed. Each option
 458  *          must be followed by a "+" for required, "?" for optional, or
 459  *          "-" for not allowed. See ValidateUrlSyntax() docs for option list.
 460  *
 461  *  The default options are changed to:
 462  *      s?H-S-E-F+u?P?a+I?p?f?q-r-
 463  *
 464  * Examples:
 465  * <code>
 466  *  validateFtpSyntax('ftp://netscape.com')
 467  *  validateFtpSyntax('moz:iesucks@netscape.com')
 468  *  validateFtpSyntax('ftp://netscape.com:2121/browsers/ns7/', 'u-')
 469  * </code>
 470  *
 471  * Author(s):
 472  *  Rod Apeldoorn - rod(at)canowhoopass(dot)com
 473  *
 474  *
 475  * Homepage:
 476  *  http://www.canowhoopass.com/
 477  *
 478  *
 479  * License:
 480  *  Copyright 2004 - Rod Apeldoorn
 481  *
 482  *  Released under same license as validateUrlSyntax(). For details, contact me.
 483  */
 484
 485 function validateFtpSyntax( $ftpaddr, $options="" ){
 486
 487     // Check Options Parameter
 488     if (!preg_match( '/^([sHSEFuPaIpfqr][+?-])*$/', $options ))
 489     {
 490         trigger_error("Options attribute malformed", E_USER_ERROR);
 491     }
 492
 493     // Set Options Array, set defaults if options are not specified
 494     // Scheme
 495     if (strpos( $options, 's') === false) $aOptions['s'] = '?';
 496     else $aOptions['s'] = substr( $options, strpos( $options, 's') + 1, 1);
 497     // http://
 498     if (strpos( $options, 'H') === false) $aOptions['H'] = '-';
 499     else $aOptions['H'] = substr( $options, strpos( $options, 'H') + 1, 1);
 500     // https:// (SSL)
 501     if (strpos( $options, 'S') === false) $aOptions['S'] = '-';
 502     else $aOptions['S'] = substr( $options, strpos( $options, 'S') + 1, 1);
 503     // mailto: (email)
 504     if (strpos( $options, 'E') === false) $aOptions['E'] = '-';
 505     else $aOptions['E'] = substr( $options, strpos( $options, 'E') + 1, 1);
 506     // ftp://
 507     if (strpos( $options, 'F') === false) $aOptions['F'] = '+';
 508     else $aOptions['F'] = substr( $options, strpos( $options, 'F') + 1, 1);
 509     // User section
 510     if (strpos( $options, 'u') === false) $aOptions['u'] = '?';
 511     else $aOptions['u'] = substr( $options, strpos( $options, 'u') + 1, 1);
 512     // Password in user section
 513     if (strpos( $options, 'P') === false) $aOptions['P'] = '?';
 514     else $aOptions['P'] = substr( $options, strpos( $options, 'P') + 1, 1);
 515     // Address Section
 516     if (strpos( $options, 'a') === false) $aOptions['a'] = '+';
 517     else $aOptions['a'] = substr( $options, strpos( $options, 'a') + 1, 1);
 518     // IP Address in address section
 519     if (strpos( $options, 'I') === false) $aOptions['I'] = '?';
 520     else $aOptions['I'] = substr( $options, strpos( $options, 'I') + 1, 1);
 521     // Port number
 522     if (strpos( $options, 'p') === false) $aOptions['p'] = '?';
 523     else $aOptions['p'] = substr( $options, strpos( $options, 'p') + 1, 1);
 524     // File Path
 525     if (strpos( $options, 'f') === false) $aOptions['f'] = '?';
 526     else $aOptions['f'] = substr( $options, strpos( $options, 'f') + 1, 1);
 527     // Query Section
 528     if (strpos( $options, 'q') === false) $aOptions['q'] = '-';
 529     else $aOptions['q'] = substr( $options, strpos( $options, 'q') + 1, 1);
 530     // Fragment (Anchor)
 531     if (strpos( $options, 'r') === false) $aOptions['r'] = '-';
 532     else $aOptions['r'] = substr( $options, strpos( $options, 'r') + 1, 1);
 533
 534     // Generate options
 535     $newoptions = '';
 536     foreach($aOptions as $key => $value)
 537     {
 538         $newoptions .= $key . $value;
 539     }
 540
 541     // DEBUGGING - Uncomment line below to display generated options
 542     // echo '<pre>' . $newoptions . '</pre>';
 543
 544     // Send to validateUrlSyntax() and return result
 545     return validateUrlSyntax( $ftpaddr, $newoptions);
 546
 547 } // END Function validateFtpSyntax()