Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/automattic/go-search-replace
🚀 Search & replace URLs in WordPress SQL files.
https://github.com/automattic/go-search-replace
golang text-processing wordpress
Last synced: about 1 month ago
JSON representation
🚀 Search & replace URLs in WordPress SQL files.
- Host: GitHub
- URL: https://github.com/automattic/go-search-replace
- Owner: Automattic
- License: gpl-3.0
- Created: 2017-10-13T15:09:08.000Z (about 7 years ago)
- Default Branch: trunk
- Last Pushed: 2024-10-07T09:54:52.000Z (about 1 month ago)
- Last Synced: 2024-10-07T11:16:54.940Z (about 1 month ago)
- Topics: golang, text-processing, wordpress
- Language: Go
- Homepage: https://wpvip.com/2018/03/28/data-sync-on-vip-go/
- Size: 67.4 KB
- Stars: 86
- Watchers: 10
- Forks: 19
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Go Search Replace
[](https://travis-ci.org/Automattic/go-search-replace)
Search & replace URLs in WordPress SQL files.
```
cat example-from.com.sql | search-replace example-from.com example-to.com > example-to.com.sql
```
## Overview
Migrating WordPress databases often requires replacing domain names. This is a
complex operation because WordPress stores PHP serialized data, which encodes
string lengths. The common method uses PHP to unserialize the data, do the
search/replace, and then re-serialize the data before writing it back to the
database. Here we replace strings in the SQL file and then fix the string
lengths.
## Considerations
Replacing strings in a SQL file can be dangerous. We have to be careful not to
modify the structure of the file in a way that would corrupt the file. For this
reason, we're limiting the search domain to roughly include characters that can
be used in domain names. Since the most common usage for search-replace is
changing domain names or switching http: to https:, this is an easy way to avoid
otherwise complex issues.
## Installation
### From Official Releases
To install on macOS:
```
wget https://github.com/Automattic/go-search-replace/releases/latest/download/go-search-replace_darwin_arm64.gz
gunzip go-search-replace_darwin_arm64.gz
chmod +x go-search-replace_darwin_arm64
mv go-search-replace_darwin_arm64 /usr/local/bin/go-search-replace
go-search-replace --version
```
### From Source
To install from source, this package requires [Go](https://golang.org/).
Note the changes you need to make to your PATH and that you have to either restart your terminal or `source` your shell rc file.
You need to install Gox which you can install with
`go install github.com/mitchellh/gox@latest`
Once that's installed you can install this tool with the following command:
`go install github.com/Automattic/go-search-replace@latest`
Go is set up by convention, not configuration so your files likely live in a directory like: /Users/user/go/src/github.com/Automattic/go-search-replace
Nagivage to that directory and run
`make`
`go-search-replace` will be ready for you to use. Once built you won't have to complete any of the above steps again.