Homec4science
Diffusion libphutil (stable) Browse

libphutil/src/parser/PhutilGitURI.php
7df0fc1297f9stable

Last Change
Raw File

PhutilGitURI.php
View Options

<?php
/**
* Parser for the alternate URI scheme used by SCP and Git, which look
* like this:
*
* user@host:path
*
* (Git calls these URIs "scp-style" in its documentation, but most users and
* developers are likely to run into them in the context of Git and I couldn't
* find an official name or specification, so I'm going with "GitURI".)
*
* Note that these URIs can not be transformed into normal URIs because the
* path is interpreted as relative on the remote, rather than absolute (as with
* normal URIs).
*/
final class PhutilGitURI {
private $user;
private $domain;
private $path;
public function __construct($uri) {
$parts = $this->parseURI($uri);
if ($parts) {
$this->user = $parts[1];
$this->domain = $parts[2];
$this->path = $parts[3];
}
}
private static function parseURI($uri) {
// See T4913. Fail the parse if there is leading whitespace; stricter
// systems will not accept these URIs.
if (ltrim($uri) !== $uri) {
return null;
}
$user = '(?:([^@]+)@)?';
$domain = '([^:]+)';
$path = ':(.*)';
$regexp = '/^'.$user.$domain.$path.'$/';
$matches = null;
$ok = preg_match($regexp, $uri, $matches);
if ($ok) {
return array_pad($matches, 4, '');
}
return null;
}
public function __toString() {
$user = null;
if ($this->user) {
$user = $this->user.'@';
}
$domain = $this->domain;
$path = $this->path;
return $user.$domain.':'.$path;
}
public function setDomain($domain) {
$this->domain = $domain;
return $this;
}
public function getDomain() {
return $this->domain;
}
public function setPath($path) {
$this->path = $path;
return $this;
}
public function getPath() {
return $this->path;
}
public function setUser($user) {
$this->user = $user;
return $this;
}
public function getUser() {
return $this->user;
}
}
c4science · Help