Update old composer blog (#449)

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Stanislav Zhuk <stasadev@gmail.com>

Author: 3 people

src/content/blog/getting-started-with-ddev-and-composer.md

@@ -1,7 +1,8 @@
 ---
 title: "Getting started with DDEV and Composer"
 pubDate: 2018-11-29
-summary: Using DDEV v1.4’s bundled Composer.
+modifiedDate: 2025-10-14
+summary: Using DDEV's bundled Composer.
 author: Randy Fay
 featureImage:
   src: /img/blog/2018/11/marius-masalar-410695-unsplash-e1543521725507.jpg
@@ -11,74 +12,69 @@ categories:
   - Guides
 ---
 
-[Composer](https://getcomposer.org) came into the PHP world to help with dependency-management—managing the growing network of external libraries that modern applications rely on. If you’re setting up a PHP development environment with Composer for TYPO3 or Drupal 8, DDEV can help make it easier. DDEV now has built-in Composer commands so you don’t have to install Composer on your host machine. You can use Composer right in the container. Overall, our goal with DDEV is to give users ultimate flexibility, yet predictability at the same time.
+[Composer](https://getcomposer.org) came into the PHP world to help with dependency-management—managing the growing network of external libraries that modern applications rely on. If you’re setting up a PHP development environment with Composer for most modern PHP environments, DDEV can help make it easier. DDEV has built-in Composer commands so you don’t have to install Composer (or PHP) on your host machine. You can use Composer right in the container. Overall, our goal with DDEV is to give users ultimate flexibility, yet predictability at the same time.
 
-[Download DDEV](https://github.com/ddev/ddev)
+[Get Started With DDEV](/get-started)
 
 ### Composer for PHP dependency management
 
 As web development evolved in the decade after PHP appeared, different web development communities began to share resources, libraries, and tools in true open source fashion. This made building applications faster but posed a new problem. This network of interconnected libraries meant any given web application could have a (potentially large) number of dependencies. What version of which library does this particular project need? How can we keep them updated?
 
 Enter Composer, the dependency manager that [took its inspiration](https://getcomposer.org/doc/00-intro.md) from dependency managers like npm. Unlike some others, Composer works on a per-project basis, pulling in the correct version of the correct libraries from repositories like Packagist, [the main Composer repository](https://getcomposer.org/doc/01-basic-usage.md#packagist).
 
-Composer is the recommended way to develop for both TYPO3 CMS and Drupal 8, but it still causes issues, particularly for Windows users. Now with DDEV’s support for Composer, you don’t even have to install Composer on your local machine. You’ll get a more predictable experience and have one less thing to worry about.
-
-## Composer and DDEV are better together
-
-Before the DDEV 1.4 release, our instructions were written assuming the typical user was a Mac or Linux user with Composer installed. It didn’t work well for lots of Windows users. The fundamental “gotcha” that proved most challenging for Windows users was that even if they get PHP and Composer set up properly on their Windows machine, they still ran into trouble when they ran the `composer create-project` command.
-
-We noticed more and more of our Windows users sharing workarounds [in our community](https://docs.ddev.com/en/stable/users/support/), such as Slack and [Stack Overflow](https://stackoverflow.com/questions/tagged/ddev). We realized how we could make this a lot easier, and in DDEV 1.4, we released several improvements to make the experience better, particularly for Windows users.
-
-The new Composer command in DDEV simplifies the use of Composer, and allows you to create and manage projects without having Composer installed on your host machine.
-
-As a bonus, we also changed Composer cache; now it resides in a shared Docker volume, making it much faster to do in-container Composer builds.
+Composer is the recommended way to develop for many PHP frameworks and CMSs, but it still can cause issues, particularly for Windows users. Now with DDEV’s support for Composer, you don’t even have to install Composer on your local machine. You’ll get a more predictable experience and have one less thing to worry about.
 
 ## Built-in Composer commands in DDEV
 
-The new `ddev composer` feature is a wrapper on Composer that does everything inside the container, eliminating the need to install Composer on the host. If you’ve used Composer before, it will seem pretty familiar, but there’s an important difference to note.
+The `ddev composer` feature is a wrapper on Composer that does everything inside the container, eliminating the need to install Composer on the host. If you’ve used Composer before, it will seem pretty familiar, but there’s an important difference to note.
 
-Our recommended [quickstart](https://docs.ddev.com/en/stable/users/quickstart/) techniques for both [TYPO3 CMS](https://docs.ddev.com/en/stable/users/quickstart/#typo3) and [Drupal 8](https://docs.ddev.com/en/stable/users/quickstart/#drupal) use Composer to create projects. You can also check out the docs on using the command line interface for [ddev and Composer](https://docs.ddev.com/en/stable/users/developer-tools/#ddev-and-composer).
+Our recommended [quickstart](https://docs.ddev.com/en/stable/users/quickstart/) techniques for [TYPO3 CMS](https://docs.ddev.com/en/stable/users/quickstart/#typo3) and [Drupal](https://docs.ddev.com/en/stable/users/quickstart/#drupal) use Composer to create projects. You can also check out the docs on using the command line interface for [ddev and Composer](https://docs.ddev.com/en/stable/users/usage/developer-tools/#ddev-and-composer).
 
 Most of the Composer features in the command line ddev app are direct analogs of Composer usage. You can prepend a Composer command with `ddev` and it works the same as the [commands in Composer](https://getcomposer.org/doc/03-cli.md). That includes
 
 - `ddev composer require`
 - `ddev composer install`
 - `ddev composer update`
+- `ddev composer create-project`
 - And so forth!
 
-The one thing that’s different is the command to create a project. If you’re familiar with Composer already, you know the [command to create a project](https://getcomposer.org/doc/03-cli.md#create-project) is this:
-
-`composer create-project`
+The one thing that’s different is `ddev composer create-project`. If you’re familiar with Composer already, you know the [command to create a project](https://getcomposer.org/doc/03-cli.md#create-project) is this:
 
-In ddev, you run this command: `ddev composer create`. For example, our [TYPO3 quickstart](https://docs.ddev.com/en/stable/users/quickstart/#typo3) recommends you run this command:
+```
+composer create-project <name> <directory> <version>
+```
 
-`ddev composer create typo3/cms-base-distribution ^9`
+In DDEV, you use `ddev composer create-project <name>` without the additional directory component (all installs are done in the current [composer_root](https://docs.ddev.com/en/stable/users/configuration/config/#composer_root), which is the project root by default). For example, our [TYPO3 quickstart](https://docs.ddev.com/en/stable/users/quickstart/#typo3) recommends you run this command:
 
-The standard Composer command requires that you are creating a project in a completely empty directory. With ddev that’s not possible, we have a .ddev directory already, if nothing else. So what ddev does in the background is to create the project in a temporary directory, then it copies back into the project root. From the command line interface, you won’t even notice it.
+```bash
+ddev composer create-project "typo3/cms-base-distribution"
+```
 
-In fact, if you do attempt to run `ddev composer create-project` you’ll get a friendly reminder that this command is unsupported, and ddev will tell you to use `ddev composer create` for basic project creation.
+The standard Composer command requires that you are creating a project in a completely empty directory. With DDEV that’s not possible, we have a `.ddev` directory already, if nothing else. So what DDEV does in the background is to create the project in a temporary directory, then it copies back into the project root. From the command line interface, you won’t even notice it.
 
-Another thing you can do is execute Composer in other directories within the container. [SSH into a container](https://docs.ddev.com/en/stable/users/cli-usage/#ssh-into-containers) to open an interactive Bash shell session to the container. Then you can use Composer ‘natively’ ([see the docs](https://docs.ddev.com/en/stable/users/developer-tools/#ddev-and-composer)). You can end the native Composer session by typing `exit`.
+Another thing you can do is execute Composer in other directories within the container. [SSH into a container](https://docs.ddev.com/en/stable/users/cli-usage/#ssh-into-containers) to open an interactive Bash shell session to the container. Then you can use Composer directly inside the container ([see the docs](https://docs.ddev.com/en/stable/users/usage/developer-tools/#ddev-and-composer)). You can end the Composer session by typing `exit`.
 
-As the [documentation on ddev and Composer explains](https://docs.ddev.com/en/stable/users/developer-tools/#ddev-and-composer), ddev will execute the Composer command at the project root in the web container, passing all arguments and flags to Composer, as the examples here show.
+As the [documentation on ddev and Composer explains](https://docs.ddev.com/en/stable/users/usage/developer-tools/#ddev-and-composer), DDEV will execute the Composer command at the project root (the path can be changed with the [composer_root](https://docs.ddev.com/en/stable/users/configuration/config/#composer_root) option) in the web container, passing all arguments and flags to Composer, as the examples here show.
 
-`ddev composer create drupal-composer/drupal-project:8.x-dev --stability dev --no-interaction`
+`ddev composer create-project "drupal/recommended-project:^11" --stability dev --no-interaction`
 
-`ddev composer create typo3/cms-base-distribution ^9`
+`ddev composer create-project "typo3/cms-base-distribution" . "^12"`
 
 `ddev composer require monolog/monolog`
 
-`ddev composer update --with-dependencies`
+`ddev composer update --with-all-dependencies`
 
 Each of these examples shows that the Composer commands will work, passing all options to Composer.
 
 ## Get started with DDEV and Composer
 
-Composer is a great solution for dependency management in PHP, but it’s still not consistently applied across operating systems. Reduce friction in your development workflows by setting up consistent versions of Composer and PHP on your local development environment and your host with DDEV, our containerized Docker-based dev-to-deploy solution.
+Composer is a great solution for dependency management in PHP, but it’s still not consistently applied across operating systems. Reduce friction in your development workflows by setting up consistent versions of Composer and PHP on your local development and deployment environments.
 
-You can use DDEV with any PHP CMS or framework. We test DDEV on—and offer [Quickstart guides](https://docs.ddev.com/en/stable/users/quickstart/) for— Drupal, WordPress, TYPO3 CMS, and Backdrop CMS. Composer is the recommended way to develop with TYPO3 CMS and Drupal.
+You can use DDEV with any PHP CMS or framework. We test DDEV on—and offer [Quickstart guides](https://docs.ddev.com/en/stable/users/quickstart/) for— Drupal, WordPress, TYPO3 CMS, Backdrop CMS and many others. Composer is the recommended way to develop with most of them, including TYPO3 CMS and Drupal.
 
 Also, check out these articles:
 
-- How to set up a [Docker-based development environment on macOS](watch-ddev-local-from-scratch-with-macos.md).
+- [Watch: DDEV from scratch with Windows WSL2](watch-ddev-local-from-scratch-with-windows-wsl2.md)
+- [DDEV on Linux in 10 Minutes](ddev-on-linux-in-10-minutes.md)
+- [Watch: DDEV From Scratch with macOS](watch-ddev-local-from-scratch-with-macos.md)
 - [Debugging Docker on Windows, Mac, and Linux](debugging-docker-on-windows-mac-and-linux.md)