Skip to content

Commit

Permalink
update docs links
Browse files Browse the repository at this point in the history
  • Loading branch information
AaronFeledy committed Nov 19, 2024
1 parent efa5266 commit ad378ef
Show file tree
Hide file tree
Showing 6 changed files with 18 additions and 18 deletions.
2 changes: 1 addition & 1 deletion docs/caveats.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,4 +25,4 @@ Lando will set the `PATH` hierarchy for this service as follows:
]
```
This is useful to note if you are not using absolute paths in any [tooling routes](https://docs.lando.dev/core/v3/tooling.html) and are getting the unexpected version of a particular utility.
This is useful to note if you are not using absolute paths in any [tooling routes](https://docs.lando.dev/landofile/tooling.html) and are getting the unexpected version of a particular utility.
14 changes: 7 additions & 7 deletions docs/config.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,9 @@ description: Learn how to configure the Lando PHP service.

# Configuration

Here are the configuration options, set to the default values, for this service. If you are unsure about where this goes or what this means, we *highly recommend* scanning the [services documentation](https://docs.lando.dev/core/v3/services/lando.html) to get a good handle on how the magicks work.
Here are the configuration options, set to the default values, for this service. If you are unsure about where this goes or what this means, we *highly recommend* scanning the [services documentation](https://docs.lando.dev/services/lando-3.html) to get a good handle on how the magicks work.

Also note that options, in addition to the [build steps](https://docs.lando.dev/core/v3/services/lando.html#build-steps) and [overrides](https://docs.lando.dev/core/v3/services/lando.html#overrides) that are available to every service, are shown below:
Also note that options, in addition to the [build steps](https://docs.lando.dev/services/lando-3.html#build-steps) and [overrides](https://docs.lando.dev/services/lando-3.html#overrides) that are available to every service, are shown below:

```yaml
services:
Expand Down Expand Up @@ -193,9 +193,9 @@ composer_version: snapshot
You can also use the `composer` key if you need to require any [global composer dependenices](https://getcomposer.org/doc/03-cli.md#require). This follows the same syntax as your normal [`composer.json`](https://getcomposer.org/doc/01-basic-usage.md#composer-json-project-setup) except written as YAML instead of JSON.

::: tip Use composer.json if you can
While there are some legitimate use cases to globally install a composer dependency, it is almost always preferred to install using your applications normal `composer.json` and then running either `lando composer install` or alternatively setting up a [build step](https://docs.lando.dev/core/v3/services/lando.html#build-steps) that will automatically run before your app starts up.
While there are some legitimate use cases to globally install a composer dependency, it is almost always preferred to install using your applications normal `composer.json` and then running either `lando composer install` or alternatively setting up a [build step](https://docs.lando.dev/services/lando-3.html#build-steps) that will automatically run before your app starts up.

Note that `lando composer` is not provided out of the box by the `php` service and needs to be manually added by configuring your app's [tooling](https://docs.lando.dev/core/v3/tooling.html).
Note that `lando composer` is not provided out of the box by the `php` service and needs to be manually added by configuring your app's [tooling](https://docs.lando.dev/landofile/tooling.html).
:::

An example of globally installing `phpunit/phpunit` `^6.5` is shown below:
Expand All @@ -208,7 +208,7 @@ services:
phpunit/phpunit: ^6.5
```

An example of using a [build step](https://docs.lando.dev/core/v3/services/lando.html#build-steps) to automatically `composer install` your dependencies before your app starts is shown below:
An example of using a [build step](https://docs.lando.dev/services/lando-3.html#build-steps) to automatically `composer install` your dependencies before your app starts is shown below:

```yaml
services:
Expand Down Expand Up @@ -273,7 +273,7 @@ lando php
lando composer
```

Lando tooling is actually pretty powerful so definitely check out [the rest](https://docs.lando.dev/core/v3/tooling.html) of its cool features.
Lando tooling is actually pretty powerful so definitely check out [the rest](https://docs.lando.dev/landofile/tooling.html) of its cool features.

## Adding routing

Expand All @@ -286,4 +286,4 @@ proxy:
- something.else.local
```

Lando proxying is actually pretty powerful so definitely check out [the rest](https://docs.lando.dev/core/v3/proxy.html) of its cool features.
Lando proxying is actually pretty powerful so definitely check out [the rest](https://docs.lando.dev/landofile/proxy.html) of its cool features.
8 changes: 4 additions & 4 deletions docs/extensions.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,11 +75,11 @@ Note that imagick is temporarily unavailable on PHP 8.3/8.4, due to a pending is

There are a few ways you can extend or modify our php images below:

* Using [build steps](https://docs.lando.dev/core/v3/services/lando.html#build-steps).
* Using your own image with [service overrides](https://docs.lando.dev/core/v3/services/lando.html#overrides).
* Building from your own local Dockerfile [service overrides](https://docs.lando.dev/core/v3/services/lando.html#using-dockerfiles).
* Using [build steps](https://docs.lando.dev/services/lando-3.html#build-steps).
* Using your own image with [service overrides](https://docs.lando.dev/services/lando-3.html#overrides).
* Building from your own local Dockerfile [service overrides](https://docs.lando.dev/services/lando-3.html#using-dockerfiles).

Consider the example that uses [build steps](https://docs.lando.dev/core/v3/services/lando.html#build-steps) to install the `memcached` php extension as follows:
Consider the example that uses [build steps](https://docs.lando.dev/services/lando-3.html#build-steps) to install the `memcached` php extension as follows:

```yaml
services:
Expand Down
2 changes: 1 addition & 1 deletion docs/guides/installing-extensions.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Also note that you may need to adapt these slightly depending on the PHP version

## 1. Using build steps

If installing your PHP extension is fairly trivial and not a long-running operation you may wish to simply use Lando [build-steps](https://docs.lando.dev/core/v3/services/lando.html#build-steps)
If installing your PHP extension is fairly trivial and not a long-running operation you may wish to simply use Lando [build-steps](https://docs.lando.dev/services/lando-3.html#build-steps)

Here is an example that uses build-steps to install the `xsl` and `stats` extensions.

Expand Down
4 changes: 2 additions & 2 deletions docs/guides/installing-node.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ We've found installing `node` inside a Lando PHP service to generally be the pat

## 1. Using build steps

Below is an example that installs `node12` using [build-steps](https://docs.lando.dev/core/v3/services/lando.html#build-steps).
Below is an example that installs `node12` using [build-steps](https://docs.lando.dev/services/lando-3.html#build-steps).

```yaml
services:
Expand All @@ -52,7 +52,7 @@ lando npm -v

## 2. Extending a Dockerfile

If you are planning to extend your service with _additional_ build steps or would like to cache the build steps for a faster `lando rebuild` you should instead consider [extending with a Dockerfile](https://docs.lando.dev/core/v3/services/lando.html#using-dockerfiles) as in the example below:
If you are planning to extend your service with _additional_ build steps or would like to cache the build steps for a faster `lando rebuild` you should instead consider [extending with a Dockerfile](https://docs.lando.dev/services/lando-3.html#using-dockerfiles) as in the example below:

**.lando.yml**

Expand Down
6 changes: 3 additions & 3 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ next: ./config.html

[PHP](https://www.php.net/) is a popular scripting language that is especially suited for web development. It is often served by either [apache](https://docs.lando.dev/plugins/apache/) or [nginx](https://docs.lando.dev/plugins/nginx/).

You can easily add it to your Lando app by adding an entry to the [services](https://docs.lando.dev/core/v3/services/lando.html) top-level config in your [Landofile](https://docs.lando.dev/core/v3).
You can easily add it to your Lando app by adding an entry to the [services](https://docs.lando.dev/services/lando-3.html) top-level config in your [Landofile](https://docs.lando.dev).

```yaml
services:
Expand All @@ -27,7 +27,7 @@ services:
* [8.0](https://hub.docker.com/r/devwithlando/php)
* **[7.4](https://hub.docker.com/r/devwithlando/php)** **(default)**
* [7.3](https://hub.docker.com/r/devwithlando/php)
* [custom](https://docs.lando.dev/core/v3/services/lando.html#overrides)
* [custom](https://docs.lando.dev/services/lando-3.html#overrides)
## Legacy versions
Expand All @@ -49,5 +49,5 @@ You can still run these versions with Lando but for all intents and purposes the
Because we use our own custom images for `php`, specifying a patch version is not currently supported.

If you **really** need to lock down to a patch version, you could consider using either a [custom compose service](https://docs.lando.dev/plugins/compose) or a service [overrides](https://docs.lando.dev/core/v3/services/lando.html#overrides).
If you **really** need to lock down to a patch version, you could consider using either a [custom compose service](https://docs.lando.dev/plugins/compose) or a service [overrides](https://docs.lando.dev/services/lando-3.html#overrides).

0 comments on commit ad378ef

Please sign in to comment.