I'm unable to get URL shortening to work locally. Is there some apache configuration required to get it working?

Ah, yeah. If you're using Apache with <VirtualHost /> directives, try something like this?

  <VirtualHost *>
    ServerName phabricator.example.com
+   ServerAlias short.url.com
    ...

Just want to sanity check this before I continue. I set the ServerAlias and started getting this page when visiting short.url.com:

Running bin/config set phabricator.allowed-uris '["http://short.url.com/"]' made it so I get the phabricator login screen when I visit short.url.com. The fact that it wants me to log in again to the short URL makes me think the allowed-uris solution isn't correct.

First screen is good.

That should go away and start working once you configure phurl.short-uri, which "configures a site which can serve the request".

You shouldn't need to touch phabricator.allowed-uris (and should empty it again).

That error could probably be more detailed, but I'm hesitant to put upstream-specific text in it ("Phurl, Phame") because it may be misleading (third-party applications are allowed to define new Sites and do similar things).

Oh I left out the fact that I had already configured phurl.short-uri but still get the "Site Not Found" message.

$ bin/config get phurl.short-uri
{
  "config": [
    {
      "key": "phurl.short-uri",
      "source": "local",
      "value": "http://short.url.com/",
      "status": "set",
      "errorInfo": null
    },
    {
      "key": "phurl.short-uri",
      "source": "database",
      "value": null,
      "status": "unset",
      "errorInfo": null
    }
  ]
}

I suppose we could link to /config/module/site/, which has a list of all Sites, but it's probably not intuitively obvious from there what's going on. It's also possible in some future world to reach this screen without running Phabricator at all (T1806), although probably unlikely.

Ah, okay. I'm not immediately sure, then -- did you restart Apache / is /config/edit/phurl.short-uri/ picking up the change?

Also, are prototype applications enabled (phabricator.show-prototypes)? If not, Phurl won't actually be installed.

Alternate/simpler test is "does /phurl/ work".

Also, are prototype applications enabled (phabricator.show-prototypes)? If not, Phurl won't actually be installed.

facepalm.jpg

Yep... that was it. All good now.

That should really have been in a day 1 "spend 10 minutes doing this stuff first" document, I started collecting this stuff in T11561.

Also the ((alias)) syntax should use the most-preferred URI, although I think that will happen automatically.

What do you mean by the ((alias)) syntax?

If you give a Phurl an "Alias", you can type ((thatalias)) in Remarkup to reference it. For example:

• U8 links to the documentation on Prototype applications, and has alias prototypes.
• If I type ((prototypes)) in Remarkup, I get this: User Guide: Prototype Applications
• That link has href "https://secure.phabricator.com/u/prototypes", but should have href "https://phurl.io/u/prototypes".

Ahh okay. I understand now. That did indeed happen automatically.