File: src/Generics/Util/UrlParser.php

Recommend this page to a friend!
  Classes of Maik Greubel  >  PHP Generics  >  src/Generics/Util/UrlParser.php  >  Download  
File: src/Generics/Util/UrlParser.php
Role: Class source
Content type: text/plain
Description: UrlParser class
Class: PHP Generics
Framework for accessing streams, sockets and logs
Author: By
Last change: Add strict return types & fix socket write bug
Add query string to url
Date: 3 years ago
Size: 2,162 bytes
 

Contents

Class file image Download
<?php

/**
 * This file is part of the PHP Generics package.
 *
 * @package Generics
 */
namespace Generics\Util;

use
Generics\Socket\InvalidUrlException;
use
Generics\Socket\Url;

/**
 * This class provides a parser to retrieve Url objects out of arbitrary URIs
 *
 * @author Maik Greubel <greubel@nkey.de>
 */
class UrlParser
{

   
/**
     * Parse a URI into a Url
     *
     * @param string $url
     * @throws InvalidUrlException
     * @return \Generics\Socket\Url
     */
   
public static function parseUrl($url): Url
   
{
       
$parts = parse_url($url);
       
        if (
false === $parts || false === Arrays::hasElement($parts, 'host') || false === Arrays::hasElement($parts, 'scheme')) {
            throw new
InvalidUrlException('The URL {url} does not contain necessary parts', array('url' => $url));
        }
       
       
$address = $parts['host'];
       
$scheme = $parts['scheme'];
       
$query = (isset($parts['query']) ? $parts['query'] : '');
       
$port = 0;
       
$path = "/";
       
        if (isset(
$parts['port'])) {
           
$port = intval($parts['port']);
        }
       
        if (
$port == 0) {
           
$port = self::getPortByScheme($scheme);
        }
       
        if (isset(
$parts['path'])) {
           
$path = $parts['path'];
        }
       
        return new
Url($address, $port, $path, $scheme, $query);
    }

   
/**
     * Get port number by scheme name.
     * The port will be the default which is defined by
     * http://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers
     *
     * @param string $scheme
     * The scheme.
     * @throws InvalidUrlException
     * @return int
     */
   
public static function getPortByScheme($scheme): int
   
{
        switch (
$scheme) {
            case
'http':
                return
80;
           
            case
'https':
                return
443;
           
            case
'ftp':
                return
21;
           
            default:
                throw new
InvalidUrlException("Scheme {scheme} is not handled!", array(
                   
'scheme' => $scheme
               
));
        }
    }
}


For more information send a message to info at phpclasses dot org.