mirror of
https://we.phorge.it/source/phorge.git
synced 2024-11-15 03:12:41 +01:00
555c0421bb
Summary: Ref T2632. Fixes T1466. Currently, we normalize slugs (and thus Phriction URIs and canonical project names) to a small number of latin characters. Instead, blacklist a few characters and permit everything else (including utf8 characters). When generating Phriction URIs, encode any utf8 characters. This means we render URIs encoded, but browsers handle this fine and display them readably in the URI and address bar, etc. The blacklisted characters are mostly for practical reasons: \x00-\x19 are control characters, `#%?` are meaningful in URIs, `+` is sometimes configured to be interprted as space by apache, etc., `<>\\` are just silly, `&= ` are largely cosmetic. This allows some silly stuff, like generating URIs with zero-width spaces and RTL markers in them. Possibly we should go blacklist those characters at some point. Depends on: D5191 Test Plan: {F34402} Reviewers: AnhNhan, chad, vrana Reviewed By: chad CC: aran Maniphest Tasks: T1466, T2632 Differential Revision: https://secure.phabricator.com/D5192
106 lines
2.7 KiB
PHP
106 lines
2.7 KiB
PHP
<?php
|
|
|
|
/**
|
|
* @group phriction
|
|
*/
|
|
final class PhrictionDocument extends PhrictionDAO
|
|
implements PhabricatorPolicyInterface {
|
|
|
|
protected $id;
|
|
protected $phid;
|
|
protected $slug;
|
|
protected $depth;
|
|
protected $contentID;
|
|
protected $status;
|
|
|
|
private $contentObject;
|
|
|
|
public function getConfiguration() {
|
|
return array(
|
|
self::CONFIG_AUX_PHID => true,
|
|
self::CONFIG_TIMESTAMPS => false,
|
|
) + parent::getConfiguration();
|
|
}
|
|
|
|
public function generatePHID() {
|
|
return PhabricatorPHID::generateNewPHID(
|
|
PhabricatorPHIDConstants::PHID_TYPE_WIKI);
|
|
}
|
|
|
|
public static function getSlugURI($slug, $type = 'document') {
|
|
static $types = array(
|
|
'document' => '/w/',
|
|
'history' => '/phriction/history/',
|
|
);
|
|
|
|
if (empty($types[$type])) {
|
|
throw new Exception("Unknown URI type '{$type}'!");
|
|
}
|
|
|
|
$prefix = $types[$type];
|
|
|
|
if ($slug == '/') {
|
|
return $prefix;
|
|
} else {
|
|
// NOTE: The effect here is to escape non-latin characters, since modern
|
|
// browsers deal with escaped UTF8 characters in a reasonable way (showing
|
|
// the user a readable URI) but older programs may not.
|
|
$slug = phutil_escape_uri($slug);
|
|
return $prefix.$slug;
|
|
}
|
|
}
|
|
|
|
public function setSlug($slug) {
|
|
$this->slug = PhabricatorSlug::normalize($slug);
|
|
$this->depth = PhabricatorSlug::getDepth($slug);
|
|
return $this;
|
|
}
|
|
|
|
public function attachContent(PhrictionContent $content) {
|
|
$this->contentObject = $content;
|
|
return $this;
|
|
}
|
|
|
|
public function getContent() {
|
|
if (!$this->contentObject) {
|
|
throw new Exception("Attach content with attachContent() first.");
|
|
}
|
|
return $this->contentObject;
|
|
}
|
|
|
|
public static function isProjectSlug($slug) {
|
|
$slug = PhabricatorSlug::normalize($slug);
|
|
$prefix = 'projects/';
|
|
if ($slug == $prefix) {
|
|
// The 'projects/' document is not itself a project slug.
|
|
return false;
|
|
}
|
|
return !strncmp($slug, $prefix, strlen($prefix));
|
|
}
|
|
|
|
public static function getProjectSlugIdentifier($slug) {
|
|
if (!self::isProjectSlug($slug)) {
|
|
throw new Exception("Slug '{$slug}' is not a project slug!");
|
|
}
|
|
|
|
$slug = PhabricatorSlug::normalize($slug);
|
|
$parts = explode('/', $slug);
|
|
return $parts[1].'/';
|
|
}
|
|
|
|
// TODO: Customize this? Copypasta from PhabricatorPaste.
|
|
public function getCapabilities() {
|
|
return array(
|
|
PhabricatorPolicyCapability::CAN_VIEW,
|
|
PhabricatorPolicyCapability::CAN_EDIT,
|
|
);
|
|
}
|
|
|
|
public function getPolicy($capability) {
|
|
return PhabricatorPolicies::POLICY_USER;
|
|
}
|
|
|
|
public function hasAutomaticCapability($capability, PhabricatorUser $user) {
|
|
return false;
|
|
}
|
|
}
|