Page Menu
Home
c4science
Search
Configure Global Search
Log In
Files
F67008202
PhabricatorRepositoryURINormalizer.php
No One
Temporary
Actions
Download File
Edit File
Delete File
View Transforms
Subscribe
Mute Notifications
Award Token
Subscribers
None
File Metadata
Details
File Info
Storage
Attached
Created
Wed, Jun 19, 09:40
Size
2 KB
Mime Type
text/x-php
Expires
Fri, Jun 21, 09:40 (2 d)
Engine
blob
Format
Raw Data
Handle
18320710
Attached To
rPH Phabricator
PhabricatorRepositoryURINormalizer.php
View Options
<?php
/**
* Normalize repository URIs. For example, these URIs are generally equivalent
* and all point at the same repository:
*
* ssh://user@host/repo
* ssh://user@host/repo/
* ssh://user@host:22/repo
* user@host:/repo
* ssh://user@host/repo.git
*
* This class can be used to normalize URIs like this, in order to detect
* alternate spellings of the same repository URI. In particular, the
* @{method:getNormalizedPath} method will return:
*
* repo
*
* ...for all of these URIs. Generally, usage looks like this:
*
* $norm_a = new PhabricatorRepositoryURINormalizer($type, $uri_a);
* $norm_b = new PhabricatorRepositoryURINormalizer($type, $uri_b);
*
* if ($norm_a->getNormalizedPath() == $norm_b->getNormalizedPath()) {
* // URIs appear to point at the same repository.
* } else {
* // URIs are very unlikely to be the same repository.
* }
*
* Because a repository can be hosted at arbitrarly many arbitrary URIs, there
* is no way to completely prevent false negatives by only examining URIs
* (that is, repositories with totally different URIs could really be the same).
* However, normalization is relatively agressive and false negatives should
* be rare: if normalization says two URIs are different repositories, they
* probably are.
*
* @task normal Normalizing URIs
*/
final
class
PhabricatorRepositoryURINormalizer
extends
Phobject
{
const
TYPE_GIT
=
'git'
;
private
$type
;
private
$uri
;
public
function
__construct
(
$type
,
$uri
)
{
switch
(
$type
)
{
case
self
::
TYPE_GIT
:
break
;
default
:
throw
new
Exception
(
pht
(
'Unknown URI type "%s"!'
));
}
$this
->
type
=
$type
;
$this
->
uri
=
$uri
;
}
/* -( Normalizing URIs )--------------------------------------------------- */
/**
* @task normal
*/
public
function
getPath
()
{
switch
(
$this
->
type
)
{
case
self
::
TYPE_GIT
:
$uri
=
new
PhutilURI
(
$this
->
uri
);
if
(
$uri
->
getProtocol
())
{
return
$uri
->
getPath
();
}
$uri
=
new
PhutilGitURI
(
$this
->
uri
);
if
(
$uri
->
getDomain
())
{
return
$uri
->
getPath
();
}
return
$this
->
uri
;
}
}
/**
* @task normal
*/
public
function
getNormalizedPath
()
{
$path
=
$this
->
getPath
();
$path
=
trim
(
$path
,
'/'
);
switch
(
$this
->
type
)
{
case
self
::
TYPE_GIT
:
$path
=
preg_replace
(
'/
\.
git$/'
,
''
,
$path
);
break
;
}
return
$path
;
}
}
Event Timeline
Log In to Comment