What?

Add prependPath option to PHP.listFiles method, which will prepend given folder path to every file found in it.

Why?

It's a common need to iterate over a list of files with each file path being an accessible path instead of only the file name. Idea mentioned in:

• Remove DOMParser from Blueprints: installPlugin and installTheme #427 (comment)

For example, this is a common pattern:

const files = await playground.listFiles( folderPath )

for (const file of files) {
	const filePath = `${folderPath}/${file}`;
	...
}

Also expressed as:

const filePaths = (await playground.listFiles( folderPath )).map(
  (name: string) => `${folderPath}/${name}`)
)

With the new option, the above can be simplified as:

const filePaths = await playground.listFiles(folderPath, { prependPath: true })

How?

• Add prependPath option to BasePHP.listFiles method
• Document the option and what it does
• Add test

Testing Instructions

1. Check out the branch.
2. Run nx test playground-blueprints