opdavies/nix-for-php-developers
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Fix headings

Browse source
This commit is contained in:
Oliver Davies 2025-08-14 09:35:01 +01:00
parent 917011db7e
commit 8d5e106317
1 changed files with 40 additions and 40 deletions
Download patch file Download diff file Expand all files Collapse all files

80
book/index.adoc
View file

@ -25,8 +25,8 @@
include::introduction/index.adoc[] include::introduction/index.adoc[]
[installing_php] [[installing_php]]
== Other ways to install PHP = Other ways to install PHP
//// ////
apt, yum, pacman, etc. System package managers. apt, yum, pacman, etc. System package managers.
@ -34,11 +34,11 @@ Homebrew on macOS and Linux.
Docker, podman, DDEV (containers). Docker, podman, DDEV (containers).
Valet/Herd? Valet/Herd?
Symfony CLI. Symfony CLI.
Is there an "official" way on php.net? Is there an "official" way on php.net? https://www.php.net/manual/en/install.php
//// ////
[different_versions] [[different_versions]]
== Different versions of PHP for different projects = Different versions of PHP for different projects
//// ////
Virtual machines. Virtual machines.
@ -53,23 +53,23 @@ Why do you need a full operating system?
Why use something specific to a particular framework? Why use something specific to a particular framework?
//// ////
[what_nix] [[what_nix]]
== What is Nix? = What is Nix?
[nix_language] [[nix_language]]
=== The language == The language
[nix_package_manager] [[nix_package_manager]]
=== The package manager == The package manager
[nix_build_tool] [[nix_build_tool]]
=== The build tool == The build tool
[nixos] [[nixos]]
=== The operating system (NixOS) == The operating system (NixOS)
[nix_benefits] [[nix_benefits]]
== What are the benefits of using Nix? = What are the benefits of using Nix?
//// ////
Lightweight. Lightweight.
@ -82,15 +82,15 @@ Lots of available packages and operating system options.
Ecosystem of tools - e.g. Home Manager. Ecosystem of tools - e.g. Home Manager.
//// ////
=== Reproducible software, not just repeatable == Reproducible software, not just repeatable
=== Imperative vs. declarative == Imperative vs. declarative
[dev_shells] [[dev_shells]]
== What are dev shells? = What are dev shells?
[direnv] [[direnv]]
== dev shells and direnv = dev shells and direnv
Using a local flake: Using a local flake:
@ -99,7 +99,7 @@ Using a local flake:
use flake . use flake .
---- ----
=== Remote dev shells == Remote dev shells
Using a remote flake: Using a remote flake:
@ -117,41 +117,41 @@ use flake "git+https://code.oliverdavies.uk/opdavies/dev-shells#php84"
This will install PHP 8.4, Composer and Phpactor without needing to create a bespoke `flake.nix`. This will install PHP 8.4, Composer and Phpactor without needing to create a bespoke `flake.nix`.
[NOTE] [NOTE]
==== ===
If you're referencing a GitHub repository, you can use the shorter `github:username/repo` format instead of the full repository URL. If you're referencing a GitHub repository, you can use the shorter `github:username/repo` format instead of the full repository URL.
==== ===
[what_flakes] [[what_flakes]]
== What are Flakes? = What are Flakes?
[flake_templates] [[flake_templates]]
=== Flake templates == Flake templates
//// ////
flake-utils flake-utils
flake-parts flake-parts
//// ////
[configuring_php] [[configuring_php]]
== Configuring PHP with Nix = Configuring PHP with Nix
[managing_services] [[managing_services]]
== Managing services without NixOS = Managing services without NixOS
[building_derivations] [[building_derivations]]
== Building derivations of PHP applications = Building derivations of PHP applications
[nix_composer] [[nix_composer]]
== Nix vs. Composer = Nix vs. Composer
//// ////
composer2nix composer2nix
//// ////
== Other usages for Nix = Other usages for Nix
//// ////
Homelab/Server Homelab/Server
//// ////
== Organising Nix configurations = Organising Nix configurations