Strange behaviour on ARM Mac

[macwinnie]

The generation of docs – especially the guide / handwritten documentation part – fails on Mac M1 / ARM hosts while running on a ARM Mac while on INTEL server all works fine ...

Expected behavior

rendering should work well

Actual behavior

Failing with nonsense error

WARNING: The requested image's platform (linux/amd64) does not match the detected host platform (linux/arm64/v8) and no specific platform was requested
phpDocumentor dev-master@feecaba

Parsing files

   1/282 [>---------------------------]   0%
  29/282 [==>-------------------------]  10%01:29:27 ALERT     [app]   Unable to parse file "src/phpDocumentor/Descriptor/Builder/Matcher.php", an error was detected: self is not a collection

  57/282 [=====>----------------------]  20%
  85/282 [========>-------------------]  30%
 113/282 [===========>----------------]  40%
 141/282 [==============>-------------]  50%
 170/282 [================>-----------]  60%
 198/282 [===================>--------]  70%
 226/282 [======================>-----]  80%
 254/282 [=========================>--]  90%
 282/282 [============================] 100%01:29:30 CRITICAL  [console] An error occurred while using the console. Message: "Could not find index file "index.rst" in "/docs" ["exception" => InvalidArgumentException { …},"message" => "Could not find index file "index.rst" in "/docs""]

In ParseDirectoryHandler.php line 68:
                                                    
  Could not find index file "index.rst" in "/docs"  
                                                    

project:run [-t|--target [TARGET]] [--cache-folder [CACHE-FOLDER]] [-f|--filename [FILENAME]] [-d|--directory [DIRECTORY]] [--encoding [ENCODING]] [--extensions [EXTENSIONS]] [-i|--ignore [IGNORE]] [--ignore-tags [IGNORE-TAGS]] [--hidden] [--ignore-symlinks|--no-ignore-symlinks] [-m|--markers [MARKERS]] [--title [TITLE]] [--force] [--validate] [--visibility [VISIBILITY]] [--defaultpackagename [DEFAULTPACKAGENAME]] [--sourcecode] [--template [TEMPLATE]] [--examples-dir [EXAMPLES-DIR]] [-s|--setting [SETTING]] [--list-settings] [--parseprivate]

Steps to reproduce the problem

E.g. try to run docker run --rm -v $(pwd):/data phpdoc/phpdoc:3 on the phpDocumentor/phpDocumentor repository itself ... produces the error provided above on a Mac M1 and a Mac M1Pro.

Your environment

Using phpDocumentor by running via latest published Docker image.

Probably a first step would be to build container images based on all relevant chip sets? Especially GitHub Actions has – with the officially mentioned workflow steps a pretty way to support multiple platforms – via docker/setup-buildx-action@v2 and the option platforms: linux/amd64,linux/arm64.

[jaapio]

This issue has been solved in v3.4

I started to investigate how to build arm images in #3561