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[]
[installing_php]
== Other ways to install PHP
[[installing_php]]
= Other ways to install PHP
////
apt, yum, pacman, etc. System package managers.
@ -34,11 +34,11 @@ Homebrew on macOS and Linux.
Docker, podman, DDEV (containers).
Valet/Herd?
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 of PHP for different projects
[[different_versions]]
= Different versions of PHP for different projects
////
Virtual machines.
@ -53,23 +53,23 @@ Why do you need a full operating system?
Why use something specific to a particular framework?
////
[what_nix]
== What is Nix?
[[what_nix]]
= What is Nix?
[nix_language]
=== The language
[[nix_language]]
== The language
[nix_package_manager]
=== The package manager
[[nix_package_manager]]
== The package manager
[nix_build_tool]
=== The build tool
[[nix_build_tool]]
== The build tool
[nixos]
=== The operating system (NixOS)
[[nixos]]
== The operating system (NixOS)
[nix_benefits]
== What are the benefits of using Nix?
[[nix_benefits]]
= What are the benefits of using Nix?
////
Lightweight.
@ -82,15 +82,15 @@ Lots of available packages and operating system options.
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]
== What are dev shells?
[[dev_shells]]
= What are dev shells?
[direnv]
== dev shells and direnv
[[direnv]]
= dev shells and direnv
Using a local flake:
@ -99,7 +99,7 @@ Using a local flake:
use flake .
----
=== Remote dev shells
== Remote dev shells
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`.
[NOTE]
====
===
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 are Flakes?
[[what_flakes]]
= What are Flakes?
[flake_templates]
=== Flake templates
[[flake_templates]]
== Flake templates
////
flake-utils
flake-parts
////
[configuring_php]
== Configuring PHP with Nix
[[configuring_php]]
= Configuring PHP with Nix
[managing_services]
== Managing services without NixOS
[[managing_services]]
= Managing services without NixOS
[building_derivations]
== Building derivations of PHP applications
[[building_derivations]]
= Building derivations of PHP applications
[nix_composer]
== Nix vs. Composer
[[nix_composer]]
= Nix vs. Composer
////
composer2nix
////
== Other usages for Nix
= Other usages for Nix
////
Homelab/Server
////
== Organising Nix configurations
= Organising Nix configurations